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Warranty Statement 

Hewlett-Packard products are warranted against defects in 
materials and workmanship. For Hewlett-Packard Desktop 
Computer Division products sold in the U.S.A. and Canada, 
this warranty applies for ninety (90) days from date of 
delivery.* Hewlett-Packard will, at its option, repair or replace 
equipment which proves to be defective during the warranty 
period. This warranty includes labor, parts, and surface 
travel costs, if any. Equipment returned to Hewlett-Packard 
for repair must be shipped freight prepaid. Repairs 
necessitated by misuse of the equipment, or by hardware, 
software, or interfacing not provided by Hewlett-Packard are 
not covered by this warranty. 

HP warrants that its software and firmware designated by HP 
for use with a CPU will execute its programming instructions 
when properly installed on that CPU. HP does not warrant 
that the operation of the CPU, software, or firmware will be 
uninterrupted or error free. 

NO OTHER WARRANTY IS EXPRESSED OR IMPLIED, 
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 
A PARTICULAR PURPOSE. HEWLETT-PACKARD SHALL 
NOT BE LIABLE FOR CONSEQUENTIAL DAMAGES. 

* For other countries, contact your local Sales and Service 
Office to determine warranty terms. 
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Printing History 



New editions of this manual will incorporate all material updated since the previous edition. 
Update packages may be issued between editions and contain replacement and additional 
pages to be merged into the manual by the user. Each updated page will be indicated by a 
revision date at the bottom of the page. A vertical bar in the margin indicates the changes on 
each page. Note that pages which are rearranged due to changes on a previous page are not 
considered revised. 

The manual printing date and part number indicate its current edition. The printing date 
changes when a new edition is printed. (Minor corrections and updates which are incorpo- 
rated at reprint do not cause the date to change.) The manual part number changes when 
extensive technical changes are incorporated. 

June 1981... First Edition 

September 1981. ..Second Edition. Revised pages: Hi, 1-7, 1-8, 1-15, 1-16 thru 1-28, 2-10, 
4-9, 4-12, 4-18, 4-32, 4-35, A-3, A-5. 

January 1982. ..Third Edition (adds 9836, HPL 2.0, Chapters 5 and 6, and an Index) 
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Introduction 

This manual serves to inform the experienced HPL programmer of differences between HP 
9825A/B Computers and the HPL 2.0 Language System of the HP 9826A and 9836A Compu- 
ters. As you gain experience using the HPL language system, you will begin to appreciate the 
changes made to the HPL programming language. In the great majority of instances, these 
changes were made to enhance or expand the utility of the HPL programming language, and to 
provide access to some of the new hardware features of the 9826 and 9836. 



What To Do and When 

First, read the "Installation" chapter of this manual so you'll be able to successfully turn on the 
9826 and start programming when you are ready. 

Second, read the chapter titled "Getting Started". This will familiarize you with the differences 
between operating the 9825 and the 9826/9836 computers. 

Third, read the chapter titled "Program Transfer" so you will know how to get your 9825 
programs up and running on the 9826 or 9836. 

Fourth, read the chapter titled "HPL Programming" to familiarize yourself with the program- 
ming differences and extensions of 9826/9836 HPL 2.0. 

Now that you know what you have to do, its time to get to it. Good luck! 
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Chapter 1 
Installation 



Introduction 

The computer can be configured to automatically load a language system from a disc when 
you switch the computer on. Alternately, the language system can be built-in using read-only 
memory (called ROM). Regardless of whether HPL is soft-loaded or built-in, it's the same 
language once loaded. 

The soft-loaded system allows a programmer to load one of many languages from a disc into 
the computer memory. This allows the programmer the flexibility to select the programming 
language and associated keyboard operating system best suited to his or her needs. 

The built-in (ROM) language system is just that, always available immediately after power-up 
or system reset. There are no delays or extra steps to ready the system. The ROM-based 
system is the most convenient choice for simply running applications programs. For maximum 
flexibility, more than one built-in language system can be installed at the same time. 

Knowing whether your computer has a soft-loaded or built-in language system is important. If 
your computer is soft-loaded (the system is loaded from disc at power-up), you need to insert 
the system disc before switching the computer on. On rare occasions, an error message may 
require you to reload the system from disc again. If your computer has more than one built-in 
language system, you need to choose the language system during power-up. Be sure to follow 
the correct power-up procedure later in this chapter. 



IMPORTANT 

If you have a soft-loaded system, be sure to produce at least one 
backup copy of the system disc right after switching the computer 
on. Refer to Copying Discs later in this chapter for more information. 
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Unpacking the Computer 

Your HP computer was thoroughly tested and inspected before being shipped to you. All 
equipment should be in good working order. After removing the computer from its carton, 
carefully check it and the accessories for any damage caused by transit. You should also 
check the accessories against the packing list supplied. Notify your HP sales office if any 
damage is found. Also file a claim with the carrier. If any items are missing, use the reply card 
supplied to order the item(s) directly from the factory. 

Now you're ready to install the computer, as explained next. 
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Installation Procedure 

Please follow this procedure to install and power-up your computer for the first time. If the 
computer doesn't power-up as expected, refer to the System Test section in this chapter. 

1. Position the Computer 

Place the computer on any convenient work surface. Be sure to leave about 50 mm (two 
inches) free on each side for air flow through the computer. Do not operate the computer in 
an area with excessive dust or airborne particulates (smoke). 
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Position the Computer to Allow Free Air Flow 



2. Check the Line-voltage Switches 



CAUTION 

THE COMPUTER CAN BE DAMAGED IF SET FOR 100 VAC OR 
120 VAC AND A HIGHER VOLTAGE IS APPLIED. CHECK THE 
LINE VOLTAGE SWITCHES BEFORE APPLYING POWER. 

The computer can be set to operate on one of four nominal line voltages: 100 Vac, 120 Vac, 
220 Vac or 240 Vac. The switches on the back of the computer were set to the line voltage in 
your area when the computer was shipped from the factory. Check the switch settings to 
ensure they are set correctly: 



-V LINE SELECTOR 



-220-H 



I-10CK 



-120- 
-240- 



100 Vac 




~V LINE SELECTOR 
-220-7- 

1-innJ 



100- 

120- 
240- 



1 20 Vac 



•V LINE SELECTOR 
^H-220- ' ' 



T 



-100^ 

—120- 
-240- 



220 Vac 



V LINE SELECTOR 
H-220- 




-100 



120- 



TO 



240 

240 Vac 



] 



Line Voltage Switch Settings 
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3. Check the Fuses 



WARNING 

TO AVOID THE POSSIBILITY OF SERIOUS INJURY, DISCON- 
NECT THE POWER CORD BEFORE REMOVING OR INSTALL- 
ING A FUSE. 

The computer has two fuses accessible on the back panel. See the next photo. One fuse 
protects the entire computer and should match the line voltage, either 100/120 Vac or 220/ 
240 Vac. (See the next table). The other fuse protects the internal power supply; its value is 
the same for any line voltage: 15 A, HP part number 2110-0054. 

Line Fuses 



Line 
Voltage 



Fuse 
Needed 



HP Part 
Number 



100, 120 
220, 240 



4 A (normal blow) 
2 A (normal blow) 



2110-0055 
2110-0002 



' Line Voltage Switches 




Internal Fuse 
Line Fuse 
Power Input Socket 



Computer Back Panel 
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4. Connect the Power Cord 

The proper power cord was selected and packed with your computer when it was shipped 
from the factory. Each cord has a ground connector to protect the operator from electrical 
shock. Check to be sure you have the correct cord for your power outlet. The available cords 
are shown next. 



WARNING 

IF A REPLACEMENT POWER CORD IS NEEDED, IT MUST 
HAVE THE SAME POLARITY AS THE ORIGINAL. OTHERWISE, 
EITHER A SAFETY HAZARD FROM ELECTRICAL SHOCK TO 
PERSONNEL OR EQUIPMENT DAMAGE MAY RESULT. 



U.K. 
8120-1351 



Australia 
8120-1369 



Europe Grounded 
8120-1689 




5& 





U.S. Grounded 
8120-1378 1 8120-0698 2 



Swiss 
8120-2104 







Computer 

Power-Input 

Socket 



Available Power Cords 



After connecting the power cord to the back panel and the power outlet, go ahead and switch 
the computer on as explained next. 



1 UL and CSA approved for 100/120 Vac operation. 

2 UL and CSA approved for 220/240 Vac operation. 



1-6 Installation 



5. Initial Power Up 

Now that you've checked the line-voltage switches, checked the fuses, connected the power 
cord and know which language system you have (soft-load or built-in), you are ready to 
switch the computer on. 

With a Built-in Language System 
If your computer has a built-in language sys- 
tem, first remove any disc in the drive and then 
press the power switch in. The computer dis- 
play takes about 10 seconds to warm up. In 
the mean time, the computer tests its memory. 
Then a "READY" message is displayed. The 
computer is now ready for your use. 







If more than one language system is built-in, 
the computer allows you to select one. For ex- 
ample: 



HPL 2,0 READY 



WHICH 
BH 



SYSTEM' 



In this example the computer found two built-in systems, BASIC (B) and HPL (H). The 
computer will wait about 10 seconds for you to select the language system by pressing the 
appropriate key. (If you press the wrong key, the computer will just beep and continue wait- 
ing. ) To select the HPL system, press the H key. 

If an appropriate key isn't pressed in time, the language system listed first (BASIC in our 
example) is automatically loaded. 

With a Soft-loaded Language System: 
If your computer has a soft-loaded operating 
system, open the disc drive door (the right drive 
on the 9836) and insert the Language System 
disc. Be sure the disc is inserted with its label up 
and facing you, as shown. Then close the door 
and press the power switch in. 
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The computer automatically looks for a 
SYSTM-type file on disc at power-up. If one is 
found, it's loaded into memory and then a 
"READY" message is displayed. For example: 



(RAH) HPL 2.0 READY 



When the Built-in System Does Not Load: 

If the computer does not display the READY message after about 10 seconds, or if a system 
error is displayed, switch the computer off, wait a few seconds and switch it on again. If the 
READY message still doesn't appear, call HP for service. See the list of service locations 
supplied with your computer. 

When the Soft-load System Does Not Load: 

If the computer does not display the READY message after about 15 seconds, or if "UNABLE 
TO FIND SYSTEM" is displayed, try to re-load the system. First remove the disc, check to be 
sure it is a system disc, and re-insert it in the disc drive. (Be sure the system disc i s in the 
right-hand drive on the 9836.) Then close the drive door and press ( SHIFT ) (PAUSE) . If the 
computer still doesn't load its system, either the system disc is defective or the computer 
requires service. Call HP for service. See the list of service locations at the back of the 
manual. 

After powering up the computer for the first time, you should verify its operation by running the 
computer tests explained under System Tests. Once computer operation is verified, switch it off 
and install any additional accessories supplied. See the next sections. 



FEDERAL COMMUNICATIONS COMMISSION 

RADIO FREQUENCY INTERFERENCE 

STATEMENT (U.S.A. ONLY) 



The Federal Communications Commission (in Subpart J of Part 15, Docket 20780) has specified that the following 
notice be brought to the attention of the users of this product. 

Warning: This equipment generates, uses, and can radiate radio frequency energy and if not installed and used in 
accordance with the instructions manual, may cause interference to radio communications. It has been tested and found 
to comply with the limits for a Class A computing device pursuant to Subpart J of Part 15 of FCC Rules, which are 
designed to provide reasonable protection against such interference when operated in a commercial environment. 
Operation of this equipment in a residential area is likely to cause interference in which case the user at his own expense 
will be required to take whatever measures may be required to correct the interference. 
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6. Install Additional Read/write Memory 



CAUTION 

THE COMPUTER MUST BE SWITCHED OFF BEFORE ANY 
ACCESSORY BOARDS ARE REMOVED OR PLUGGED IN. 
PLUGGING OR UNPLUGGING BOARDS WITH THE POWER 
APPLIED WILL DAMAGE THE BOARD OR THE CO MPUTER. 

The computer's program and data-storage memory can be expanded by installing additional 
read/write memory boards. Each memory board can be plugged into any available accessory 
slot at the back of the computer. 

Before installing a memory board, note the amount of available read/write memory by first 
switching the computer on: 



123456 Au ail able bytes 



Now switch the computer off and remove the memory board from its anti-static plastic 
package. 



CAUTION 

STATIC DISCHARGE CAN DESTROY COMPONENTS ON A 
MEMORY BOARD. HANDLE THE BOARD BY USING ITS ANTI- 
STATIC ENVELOPE. DO NOT TOUCH THE ELECTRICAL 
TRACES OR SET THE BOARD ON ANY STATICALLY 
CHARGED SURFACE (E.G., A CLOTH). 



Each memory board must be set to a consecutive starting address, beginning with the lowest 
address of any memory board(s) currently installed. Each board has a mini-switch labelled 
SW-1 for this purpose. The following table and drawing show how to set the switch. 

The standard computer is supplied with 64 kbytes of built-in memory. The standard memory 
board is assigned the starting hexadecimal address FF. Each additional 64 kbyte board must 
be set to the next-lowest hexadecimal address: FE, FD, etc. Memory boards must not be set to 
the same address. 
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64 kbyte Memory Board Starting Addresses 





Starting 


Switch Setting* 


Memory Board 


Address 


12345678 


1 st memory board 


FF 


11111111 


2 nd additional board 


FE 


01111111 


3 rd additional board 


FD 


10111111 


4 th additional board 


FC 


00111111 


5 lh additional board 


FB 


11011111 


6 th additional board 


FA 


01011111 


7 th additional board 


F9 


10011111 


8 th additional board 


F8 


00011111 



"1" in< 



dicates switch is open: "0" indicates switch is closed. 




98254A Memory Board Starting Address Switch 

(shown set to address FC) 



The 98256A Memory boards contain four 64k blocks, but only six switch segments are needed to 
determine the address block. Segments 6 through 3 determine the first hex digit; segments 2 and 
1 determine the second hex digit. For instance, this switch is set to binary 1 lOlOlxx which covers 
starting addresses D8, D9, DA and DB (the xx segments are don't cares): 

Note 

Some boards may have six 
segment switches. A dot in the 
lower-left corner indicates the 
OPEN position of each 

switch. 




After installing each memory board, switch the computer on and verify the new amount of 
available memory. 

If the available memory does not increase with each added memory board, switch the compu- 
ter off and verify that the board is properly seated in the accessory slot. Also check the setting 
of the starting address switch. If it's not set to the highest-available address, the computer 
cannot address the board. 

If the computer still doesn't indicate an increase in available memory, or the computer does 
not power-up correctly when an additional memory board is installed, switch the computer 
off, remove the board and replace it in its anti-static envelope. Then call HP for details on 
replacing the board. 



09826-90040, rev: 1/82 



1-10 Installation 



7. Install Interface Cards 

Now that your computer is installed and configured with any additional read/write memory, 
you can install interface cards and connect peripheral components to the computer. Be sure 
to switch the computer off before plugging in or removing any cards or memory boards. 

The computer has eight accessory slots. Each can hold a memory board, while every other slot 
is designed to accept an interface card. This allows installing up to four interface cards and at 
least four memory boards. The built-in HPL language system is contained on one board 
already installed. This board must not be removed. 




Installing Interface Cards 

A manual provided with each interface card explains how to configure the card for your 
system. Follow those instructions carefully to ensure a smooth installation: 

Be sure each interface card is set to a unique address or select code. A switch on each card 
sets its select code. These codes are already reserved by the computer: 

HPL Internal Select Codes 

Keyboard and CRT Display Line 
7 HP-IB interface (built-in) 
16 CRT Print Area 



As shown, select codes 0,7,and 16 are reserved for the computer's internal use. That leaves 
select codes 1 thru 6 and 8 thru 15 for external interface cards. 
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Maintaining Your Computer 

Cleaning the Computer 

The computer should be cleaned with a soft cloth lightly dampened either in clean water or a 
mild detergent. Don't allow water to get in the computer case. Don't use any abrasive 
cleaners. 

Clean the Disc Drive Heads 

The disc drive's read/write heads should be cleaned periodically to ensure trouble-free opera- 
tion. A head-cleaning kit is available from HP for use with your computer. Order HP acces- 
sory number 92193A. HP does not recommend use of other head-cleaning discs or equip- 
ment. 



CAUTION 

DO NOT ATTEMPT TO CLEAN THE DISC READ/WRITE 
HEADS MANUALLY OR WITH MATERIALS OTHER THAN 
THOSE SUPPLIED BY HP. OTHERWISE HEAD DAMAGE OR 
MIS-ALIGNMENT COULD OCCUR. 

To clean the disc read-write heads: 

1. Switch the computer off. 

2. Insert System Test Disc 1 in the disc drive and close the drive door. 

3. Switch the computer on. The system test program is automatically loaded. 

4. When the initial System Test menu is displayed, press either Clean heads softkey, k1 or 
k6. Then follow the displayed instructions. 
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Flexible Discs 

This section introduces you to the flexible disc media and explains how to copy (back up) the 
contents of one disc to another. HPL operating commands are available for initializing discs, 
cataloging disc files and purging disc files. These and other commands are explained in Chap- 
ter 4. 

The built-in disc drive handles standard 5Vi inch flexible discs. The flexible disc, also called a 
mini-disc and a diskette, is a thin piece of plastic enclosed in a special plastic jacket. The disc 
is covered with a thin oxide coating on which your program and data information are stored. 

When you insert the disc in the drive and close the door, the drive is ready to read informa- 
tion from or write information onto the disc. When the computer requests a read or write, the 
disc spins at a constant rate, (like a phonograph record). The yellow light on the disc drive 
indicates that reading or writing is taking place. Do not attempt to remove the disc when the 
yellow light is on. 

The built-in disc drive reads and writes on both sides of the disc and requires discs labeled for 
"double-sided" and "double density" use. Be sure to use only media supplied or approved 
by HP. Boxes of ten discs are available by ordering HP part number 92190A. Other discs 
may not be of adequate quality or may damage the drive. 

Disc Handling Precautions 

Be sure to follow these guidelines to ensure trouble-free operation: 

• Handle discs only by the labeled area. Never touch the disc surface which shows through 
the protective jacket. 

• Always return the disc to its storage envelope after each use. The envelope not only 
protects the disc from physical damage, it's made of an anti-static material to prevent 
dust from accumulating. 

• Write only on the disc label using only a felt-tip pen. Don't write on the disc jacket. Don't 
use a lead pencil or a ball-point pen. 

• Although the disc is flexible, don't bend or fold it. 

• Avoid using or storing discs in temperature extremes, or in areas with excessive smoke or 
dust. Even cigarette ash can damage the disc surface. Close the disc drive door when it's 
not in use. 

• Do not place discs near sources of strong magnetism, such as an electric motor or toy 
magnet. This will destroy data on the disc and may prevent further use of the disc. 

• Do not attempt to clean the disc or remove it from its protective jacket. 

• Use only discs approved by HP. Others may impair data integrity or damage the disc 
drive. 

Note 

Do not use more than two layers of adhesive labels on a disc. Addi- 
tional labels could cause the disc to jam in the drive or prevent 
reliable disc operation. 
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Inserting and Removing Discs 

Open the drive door by lifting the door handle 
up. Check to make sure there is not another 
disc in the drive already. Insert the disc as 
shown on the right. Close the door. 

Be sure to return the disc to its storage en- 
velope when not in use. This keeps dust from 
getting on the oxide surface. Also close the 
drive door when not in use. 



•////■.■■J"-.-- ■•.;.'..•-•.;■■.-;•.•'•- '■■■'* 
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CAUTION 

IF YOU ACCIDENTALLY INSERT ANOTHER DISC WHEN ONE 
IS ALREADY IN THE DRIVE, REMOVE THE BOTTOM DISC 
FIRST. OTHERWISE, THE READ/WRITE HEADS COULD BE 
DAMAGED. 



Write Protection 

Covering or uncovering a notch in the disc jacket 
determines whether the disc drive can write in- 
formation on the disc. When the notch is covered, 
it's impossible for the drive to write on the disc; thus 
information already on the disc is protected from 
being written over or erased. This is useful when a 
disc contains source information which should only 
be read. 

Labels are supplied with discs to allow you to cover 
the write-enable notch. 




oxide 


write 


surface 


enable 




notch 
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Data File Compatibility 

The built-in disc drive initializes discs in a standard HP mass storage format called LIF (for 
Logical Interchange Format) ensuring that files originated by one HP 9826 or 9836 will be 
compatible with other 9826 or 9836 computers and Language Systems. The standard format 
also allows the computers to identify and read certain files from other HP computers and 
terminals. For example, type ASCII files (containing data and programs) originated by an HP 
2642 Terminal can be read by the HP 9826/9836. Type ASCII files originated by the HP 
9826/9836 Computer can be read by the HP 2642A Terminal. Other type files originated by 
the computer may be identified but may not be read by the terminal. 

For details on mass storage compatibility with other HP equipment, refer to the Disc Program- 
ming Technical Appendix or contact your HP sales office. Locations are listed at the back of 
the manual. 

Using Discs 

The first step to take to use a new disc (NOT your HPL System disc!) is to insert it as de- 
scribed previously, and initialize it. You must initialize a disc whether you are using tape file 
commands or disc programming commands. To initialize a disc in the internal disc drive, unit 
zero, execute 

i n i t "lit " 

The initialization process takes about two and a half minutes. Once initialized, the disc can be 
used to save and get programs and data. It can be also used to store and load programs just 
as if it were a tape cartridge. 

To use the disc with disc statements, you should first become familiar with disc structure and 
usage. The basics of disc programming are discussed in the 9825 Disc Programming Manual 
included with your HPL Language System. Additions and extensions to 9825 disc program- 
ming that are provided for the 9826 and 9836 are described in the Disc Programming section of 
Chapter 4 of this manual. Some of the technical aspects of disc programming are discussed in 
the Disc Programming Technical Appendix to this manual. 

To simply save a program you have typed in, the procedure is simple. With the initialized disc 
in the drive, your program in memory, and assuming you wish to call your program 
"PROGRAM1" 

press: s a u e (this is special function key kO) 

type: PROGRA M i (this displays save " P R G R A M 1 " ) 

press: ( EXECUTE ) (the program is saved to disc) 

To retrieve that program off the disc, a similar procedure is followed. 

press: set (this is a special function key k1 ) 

type: PROGRA M 1 (this displays Se t " PROGR AMI ") 

press: ( EXECUTE ) (the program is loaded into memory) 

To determine what programs are on the disc, you merely press one key. 

press: * c a t (this is special function key k4) 
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The disc catalog (or directory) is listed on the display. 

If you wish to use 9825-type tape commands, you must still "mark" files just as if there were 
a tape cartridge inserted in the computer. Then commands such as rcf and ldf can be used to 
store and load programs and data. Refer to the Tape Cartridge Operations section of Chapter 
4 in this manual for additional topics of concern when using tape commands. 

Copying Discs 

Although flexible discs are an extremely reliable storage media, like phonograph records, they 
do wear out. Since discs can also be damaged due to accidents or careless handling, you should 
keep a duplicate or back-up copy of each important disc. HPL programs are provided in the 
Utilities Pack to copy the files from one disc to another on the 9826. On the 9836, use the 
"copy" statement described below. The "cbackup" (complete backup) program automatically 
copies all files from one disc to another. The "ibackup" (individual backup) program allows 
copying selected files to the same disc or a second disc. 

The cbackup program can be used to copy all files from a disc originated by an HP 9826 
Computer. Although the program runs on the HPL language system, it copies disc files con- 
taining BASIC, HPL and other programs originated on an HP 9826. cbackup will also copy 
files from mini discs recorded on other HP equipment which conforms to LIF (Logic Inter- 
change Format) standards. Your HP sales office can furnish a list of LIF-compatible equip- 
ment. 

The cbackup program copies files from one disc to another by reading portions of the first 
(master) disc into computer memory and writing each portion onto the second (backup) disc. 
Since only one disc drive is available, the program asks you to exchange the master disc for 
the backup disc one or more times. After you insert the master disc, the program catalogs the 
files and determines how many disc exchanges will be needed to copy all files to the backup 
disc. 

The "cbackup" program overwrites any files on the destination disc. The program also auto- 
matically initializes the destination disc if requested. 

On the 9826, follow these steps: 



1. Switch the computer on and load the HPL language system (see Chapter 1). 

If the HPL system is already loaded, ex- 
ecute this command to clear the computer 



memory: erase a ( EXECUTE ) 

2. Insert the HPL Utilities Disc in the drive and close the drive door. 



3. Load and run the cbackup program: get " c b a c k u p " ( EXECUTE ] 

("run") 

4. Follow the displayed instructions. 
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Note 

Be sure to press the CONTINUE key when instructed, not the RUN 
key. If RUN is pressed after the program has started, the pro- 
gram must be stopped and restarted. Return to step 1 above. 

On the 9836, follow these steps: 

1. Load the HPL Language System. 

2. Insert the source disc into drive 0, the right-hand drive. 

3. Insert the initialized destination disc into drive 1, the left drive. 

4. Execute: copy " : I ,0" t " t o " » " : I f 1 " 
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System Tests 



The computer automatically tests its read/write memory each time power is applied. After this 
test is passed, the language system is loaded. Other tests are available for you to check interface 
cards and selected HP devices connected to the computer. These tests are stored on the System 
Test Disc supplied with the computer. This section describes how to load and run the system 
tests. 

The system tests can be run on either an HP 9826 or 9836 Computer having either a soft- 
loaded or a built-in language system. The test program requires a computer with at least 196k 
bytes of read/write (RAM) memory. When using a computer with built-in (ROM) HPL, how- 
ever, only 64k bytes of RAM are needed. The computer automatically loads a special operating 
system from the System Test Disc when the computer is switched on. 



Note 

The System Tests will not run on a computer with ROM BASIC and 
only 64k bytes of RAM. 

If the computer cannot load and successfully run one or more of the tests as described here, 
switch the computer off and call HP for service. Service offices are listed at the back of this 
manual. 

Loading the System Tests 

If the computer has at least 196k bytes of RAM, follow these steps: 

1. Switch the computer off. 

2. Insert disc 1, 09836-10034, in the disc drive and close the door. 

3. Switch the computer on. The computer automatically does its memory test. Then the test 
operating system and system test program are loaded from disc. 



Note 

If the computer does not have sufficient user memory (RAM) to 
automatically load the operating system and program, an error is 
displayed. If the computer has ROM-based HPL and 64k bytes of 
RAM, you can still run the tests by typing in: 



Set "AUTQSTH" »0»0 ( EXECUTE ) 
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The system tests display a series of menus, allowing you to select various tests and enter 
parameters. The initial menu is: 



System Test Program for 982GA/36A (revision A) 



Press a softkey to select either: 

* I/O and Peripheral tests i or 

* the internal disc head cleaning 



routine 



z 



I/O and 



Pe r i ph . 



Clean 



heads 



Select the test group by pressing one of the appropriate softkeys. For instance, to run the I/O 
and Peripheral tests press either k1 or k6. 

The selected tests are now loaded. See the appropriate instructions on the following pages. 
For details on running the clean heads routine, see page 1-11. 

The EXIT Softkey 

The system tests display an EXIT softkey at various times. Whenever an EXIT softkey is 
displayed, you can press it to cancel the current operation. The program will either return to 
the previously displayed menu or exit the tests altogether. 



09826-90040, rev: 1/82 



Installation 1-19 



Interface and Peripheral Tests 

After selecting the interface/peripheral tests, the computer lists the interfaces currently avail- 
able. For example: 



LOGGED-IN SELECT CODES; 
7 int. H P - I B 
12 GPIO 



16 CRT 



******************************** 



NOTE: 
THE MAXIMUM EXTERNAL SEL- 
LECT CODE WHICH WILL WORK 
WITH THIS TEST IS 15. 



* 
* 
* 
* 
* 
* 
* 
* 



******************************** 



Do you want error 1 o 3 3 i n 3 resricted to the CRT' 



The computer logs all available select codes. If an external device to be tested is at a select 
code above 15, change the interface select code before continuing: 

1. Exit the system tests and switch the computer off. 

2. Remove the interface card and change the select code to an unused number below 16. 
Reserved select codes are listed in chapter 1. 

3. Re-install the interface card and switch the computer on. 

4. Reload the System Tests and press the I/O & Periph. softkey. 

Error Logging — After reviewing the available select codes, specify where any errors occur- 
ring during the tests should be logged. Press the Yes (kO) softkey to select error logging on the 
internal display or press No (k1) to log errors on an external device. 

If you select external error logging, use the cursor knob to move the displayed arrow to the 
correct device selector. Then press Choice Complete (kO or k5). 



Note 

The error-logging device cannot be the same device to be tested. 
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Select the Test - The next menu lists the tests available. Specify the device to be tested by 
moving the displayed arrow next to the product number and pressing Choice Complete (kO or 
k5). 

Specify the Device Selector - The next menu allows you to select the device selector. Move 
the arrow to the correct number and press Choice Complete (kO or k5). 

Specify the Number of Test Cycles - To run the test once, simply press Choice Complete 
(kO or k5). Alternately, move the arrow to the desired repeat factor and press Choice Com- 
plete. 

Specify any Optional Parameters - Some device tests support optional parameters, such 
are running a "long" or "short" test. An optional menu allows you to select these parameters. 
Refer to the optional parameters listed in the appropriate following section. Then move the 
displayed arrow to each selected parameter and press Choose param (kO or k5). When you're 
done choosing parameters, press (k1 or k6). 

Review Selections and Run the Test - Before starting each test, verify the displayed test 
title, device selector and any selected optional parameters. Read the appropriate following 
section so you know what to expect. Then press Start Program (kO or k5). 

GPIO, RS-232, BCD and HP-IB Interface Tests 

These tests check interface card functions by directing you to move switches on the card. 
Before starting each interface test, follow the next steps. 

Note 

Most interface tests require use of an extender board and a test 
connector, as describes below. 



CAUTION 

SWITCH THE COMPUTER OFF BEFORE REMOVING OR IN- 
STALLING INTERFACE CARDS. 

1. Switch the computer off and remove the interface card. 

2. Note the setting of each DIP (dual in-line package) switch on the card. Return each 
switch to its original position after completing the test. 

3. Install the card extender board, part no. 09826-66544, in an interface slot and plug the 
interface card into the extender board. See the next photo. 

4. Connect an appropriate test connector on the interface card: 



Interface 


Test Connector 


HP 98622A 


98622-67950 


HP 98623A 


98623-67950 


HP 98624A 


(use the built-in HP-IB) 


HP 98626A 


98626-67950 


HP 98628A 


1251-6625 (male) 




1251-6624 (female) 
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CAUTION 

USE THE CORRECT TEST CONNECTOR. RUNNING A TEST 
WITH THE WRONG CONNECTOR MAY DAMAGE THE INTER- 
FACE CARD. 

5. Switch the computer on, load the System Tests and start the appropriate interface test. 
Follow the displayed instructions to check the interface functions. If any errors are log- 
ged, note them and call HP for service. 

The 98622A GPIO Test automatically tests a 98620A DMA Card when it's installed and the 
Burst jumper is removed from the GPIO card. 

Internal HP-IB Interface Test 

The int. HP-IB test allows you to check the built-in HP-IB interface. The test requires use of 
an second HP-IB interface card, HP 98624A, and a standard HP-IB cable. Follow the display- 
ed instructions to run the test. 

The int. HP-IB test automatically tests an 98620A DMA Interface card, if installed. 

HP 2631 Printer Test 

This test allows you to check an HP 2631A/B/G Printer. The test assumes the printer is 
connected via the HP-IB. 

Be sure to load 14-inch wide paper and align it at the top-of-form (TOF) mark. Reset the 
printer and switch it on-line. Then press Start Test (kO). The test generates a four-page print- 
out. A sample is shown. 
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Page one includes vertical form control tests and various line spacings: 



..'6J1 EXERCISER UN 9826ft DESKTOP COMPUTER 
SINGLE SPACE VFC SLEU 
SINGLE SPACE VFC SLEW 

DOUBLE SPACE VFC SLEU 

DOUBLE SPACE VFC SLEU 

TRIPLE SPACE VFC SLEW 



liUARTER PAGE VFC SLEU 
1 LINE PER INCH «•»• 



LINES PER INCH 



LINES PI R INCH 



.3 LINES PER INCH 
3 L INLS PER INCH 



LINES PER IUCH 



LINES PER INCH *>** 
LINES PER INCH **«x 



1NE! 



PER INCH 
INCH 



LINES [•> p. 

L INES PF R INCH 

LINES PER 

1 INLS PER 

LINES PER 

LINES 

LINES PER INCH 
PER INCH 
PER INCH 



INCH 
INCH 
I NCH 
PER INCH 



I INES 

i (NEC 

LINES 
LINES PER 
I INES PER 
LINES PER 
I. INES PER 

Mil M 



INCH 
INCH 
INCH 



J:: 



if 



II t 



5555 

mi 



nn 
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Page two is the 2631 self test. Check for missing characters and the correct top-of-form 
printing: 

.-.'631 EXERCISE.R UN 9826 DESKTOP COMPUTER TOP OF FORM 

COMPUTER INITIATED SELF TEST 

I "*«&' ( )■■ i , . 7 UI 23456739: ;< = >?BftBCDEF , CHIJKL.«NQPHRB1UVUXTZi \ I "_' Jhr clef (Jh I jk I nnopqr- 1 o ,»> y .- ! I > • 

' "*»%.<,' ( l«f, ■ ./ 01 23456789: ; ! = > ?8ABCDEFGH1 JKLHNOPqRSl UUUXYZ I \ J * ' .it.cdpFqh I jk Inn opqr- •-- 1 .1 ywxy 7 (. I >' I 
I ■'*$%& ' 0*+,- 70123456709 : ; < - > '.'PABCDFF GH IJKLMNDPQ.RS 1 IJVUXrZ i \ ] " 'abcdeFqh :; J k Innopq," * t u y wx y z < I .:' • 
■«»'ll«t,-./ll23fa?89:;( = >!aiilCDEFHfiJ«LI«0f«SHMttR[\]- •abc4pf]hijtlmipqr5t«.».y!( iTI 

I " «■ <l> X. A. ' < > ■* ■*• , ■•■■ . / O 1 J." VS •<* S C:> V Si «i> : j < ■- > ? <•> A £< G I> I- I" G IT i ,J l< I... M M O I -' Q R SI! T I J WUXY >' I N. T " 
<■■> ■(-*- <:j l'i :i. J l< J. M n o |:> <T r- ?=> T u M u* X y ■?. <1 I i> "' IK 
<Zy±"ih ' l 'iU; ■ 7 012345 67B9: ; < = > .eAB CDEFGHI JRLMNOPaRST UOUXY ZI M ' ■ abcdef ah 1 1 k lnnilpnr 5ln»u. y 1 1 I jrj 

ViMWMS.Wt's'sVt ' "*«».' '• >*+,-./ 1)12 5456789: ; ' = > 7BABC"iEFGHI.TKI..MNOPQPSTUyUXY 1 1 \ !- _ ' jhtclp fghi J '■ 1 nn opqr -it 11 i>u < y - . I ) is, 

Vl-' 

BE.l. F iESi PASSED 

01234567891 

DID THIS LINE OF INTER M JXE', PRINT ME iHB 1* TEH SIH6LE 5:> P A ( E .:> I IV CI M T HE 1 1 1- 1 M A I-; G E N 7 



Page three includes display functions characters and secondary character sets: 

DISPLAY FUNCTIONS 

W«W«tVVr<k . , v .„, , 

'fcW'i^W^'eSi^W'^'i ' "t*7.*>' < >* + , ■ 7 123456789 ; ; < ;0 'eABCDEF GHI., Kt.nNOPuRS HivwXYZ i '■ i " . a).; d>- r cj ! i jk , nnopqr ''> * >> v«< y / , > I-oT 

THIS IS (HE SECONDARY CHARACTER SET BY SHIFT OUT -SHIFT IN 

i "*$7.1'<>*> , ./(1 123456789; ; < = > VSABCDE FGHI JKLMNOPQRS 1 UVUIXYZ [ \ J » ■ abc<J<K gh 1 j k Inn opqr t. 1 'J «»> y z ( I 1 I 

1 "*!!%*,' i )**, ■/ 0123456789: ; < = : ?j?ABCDEEGHI JkLMNOPQRSTUUUXYZ I :\ ] ' x ab<: def qF.i .ik I npopqr ; :;T u yUKy 1 {. I 1 f 

THIS IS THE SECONDAPT CHARACTER SS T BY EIGHTH BIT 

i "ttXi <)«*,■■ . /I) 123456789: ; < -■) 'SABCDEFGKi J'KLMNOPURS T UUUXY Z I ' 1 ' _ ' ,16 ( Cef gni Jk Innlipqr- t „ yuxy • : ! j I 

' "#$X4' 1 >*+ , .70123456789; ; < ■■■; >?eABCDEFGHIJI<L nNUP«RSTUUW<YZ [ \ ) \. dbcdefqhl Jk I nnopqr ST u uuk y / { I ) I 

ItST FOR FAST ';>""' <" nf I,: '"'"''' 

TEST FOR FAS I •>■"' '■'- 1 ' l( BL'INKS 

TEST FUR TA51 SK "' "'-"' R f " nNKh 



Page four prints test lines at preset spacings, allowing you to check for correct line spacings: 

IB THIS THE SLIDE SU I 1 CH PRINT MODE AND LINE SPACING? 
"»«%&- ( )«+,-. 701 23456789: j < = > JSABCDEFCHI .TKLMNOPQRSTLIVUXYZ I\ I *_ ' dbcdef gh i jklnnopqrsTuyu* y .■ :l I !"• 



! "*t%4 - <)»+,- ,70123456789 
1 "**X4' ()«+,-. 7 01 23456789 



;< = >?&>ABCDEFGHI.JKL.MNOPQRSTUUUXYZl\)\. / ahcdefqhi jk Innopqr 51 u vuxy 2 I 

. <^>?PABCDEFGHIJKL MNOPQRSTUUWXYZIM A _ ' abcdef qhi Jk lnnopqr sx 11 y ux y 1 { I >' S 



IS THIS THE SLIDE SWITCH PRINT MODE AT 6 LINES PER INCH? 

"*f7.4 - ()«+, -.70123456789 
! "t»7.4- ( )>< , .70123456789 
! ■'♦»24' 1 >«-! , -■ .70123456789 



;< = >?e»ABCDEFGHIJKLMNOPQRSTUUWXYZI\l-... ' apcdef ghi Jk J nn opqr !tura>(,-(.l; • 

< = >?eABCDEFGHIJ«LMNOPQRSTUUUXYZE\r . . ' abcdefghi jk 1 nn opqr it u yux y / I n't 

< = >?6>ABCDEFGHIJKLMNOPaRSTUUUXYZL\)-_ ' abcdef qhi Jk .1 nn opqr St u uux y 2 C 111 

- - - test pass c.o«plete 

The character sets printed on pages two and three depend on the character-set ROMs instal- 
led in the printer. 
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HP 9866A and 9866B Tests 

These tests allow you to check operation of an HP 9866A or 9866B Printer. The test assumes 
the printer is connected via a 98622A Option 004 GPIO interface. 

The character-set printout is identical for each test. The character dot-pattern test is run on the 
9866B to verify plotting capability. 

Check for missing characters or dots. If dots are missing, line after line, the printer needs 
service. 



EEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEE 
fiBCBEFGHIJKLMNOFQRST 
a b c d e f 9 h i J k 1 n n o f> <\ r s t 
i •#$'•;?•' 0*+< -./01?3 
Cr]t-'ti" 

i i t i t I t t t it i i f i i .£ k y i 

1 1 1 i; t i i l i: t U i > 1 1 -. i s: k 



EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEt 
EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEF 
EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEF 
EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEFE 
EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE! 

uvwxvz 

uuwxvz 
456789: j < = >?i? 



EEEEEEEEEEEEEEEEEEEtt 
EEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEE 
EEEEEEEEEEEEEEEEEEEEE 



EEEEEE 

EEEEEE 
EEEEEE 
EEEEEE 
EEEEE 
EEEEEE 
EEEEEE 
EEEEEE 
EEEEEE 
EEEEEE 
EEEEEE 
EEEEEE 
EEEEEE 
EEEEEE 



■* i" >' ' : k> k b > t' L' k' L' -' ' <" -" L* '--: -■ ;" ! ■ 




( t t i t i t . i: W k L* k k 
k k £ k Jc £ k £ t li: k £ k . 



k -, : 



» k .K k t ^ k tii l t > i k x k >: t > ic y w w t k « it k: k: t y t t k it >: it k: t t k: k- k: K 

if if. if l; .i; if. If .if If. 1 1 it i i tf r . : i, 1 k if It 1 if 1 t f if if if £ f £ f i' t i s , i t k if K' 
i :i>!ti:,:!i'i: t'c ;,c.. .,'.:* i - :t :;'; L , qi [; L' it !; i, i :;.!,;[,■[.: ; ;■■:■■;•;. 



k ,£ jk £ .ik I 



: ^ ,* ^ , n 

'. t a; . k -': 






i :-■ - > 



:!: £ i! : k : :!: 

*. ,: i^' ! : ;i.r',' 



£C 



;h,. 






: L k > L ■:.-,: k . ■ 

■ i lb £ It' it': ■■•■ 1 1- =c - 



:. >: ^ .k .S 






,:: H 
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HP 9872 Plotter Tests 

The 9872_all test allows you to check HP plotters connected via HP-IB. This includes HP 
9872A/B/C Plotters and 7225A Plotters. 

The test first resets the plotter and waits for you to load paper and ready the plotter. Then 
pless the Continue softkey (kO) to start the test. A sample plot is shown below. 



qtz/xMAn^s-jbdouui^rTHS^P ^, - . c\]ZAX«AnisyodONW"iHriHDd3a3avei<:=> ! 'Beigstezia/ ■- *+»o -3%^ 

PO _ — ! >- 

X 



s 

IN) 
0) 
■^ 
01 
0) 

-J 

CD 
CO 



V 

-J 

ID 
> 

CD 

n 

□ 
m 

Tl 

o 
i 
i— i 
u 



z 
o 

□ 

in 

-H 
C 
< 

X 

-< 

N 




HEWLETT PACKARD DYNAMIC PERFORMANCE VERIFICATION TEST 



\HEVILETT 
PACKARD 



oasoSsty as , &t//-c7/?i?& 




^?So£ 



SAN DIEGO 



QUALITY 
PLOTTER 




DIVISION 



> 

z> 

H 
10 
Ct 
O 
CL 
D 
Z 



I 

u 

LL 

UJ 

o 
u 

CD 
< 

o 

A 

II 
V 



0) 
CD 
IS 
CO 

in 
■* 

CD 
CNI 

H 
S 



5-5 
6» 



O »+, -. /0123456789: ; <=>?eABCDEFGHIJKLMNOPQRSTUVWXYZ C\3 "_'abcdof g hi jkltnnopqr-stuvwxyzl 



HP 9876A Printer Test 

This test allows you to check the printer's available character sets and character re-definition. 
Before running the test, be sure the printer is switched on. Then load paper and set it at 
top-of-form. 
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A sample printout is shown below. Verify that all characters are printed as shown. The saw- 
tooth pattern allows you to check for uniform print intensity. Check for missing dots. 

rwrwrrrrrrrrwrvrrrrrrrrrrrrrrrwrvrwrvwrwrrrrvrrrrrrrrrvrrrrrrvrrrrrrrr 

%*t'i I S> I S t '.« , SS,%fc&%5:'s'i'!; , i ! " #*5i& '<)*+,-. • e 123456789: ; < = > ?CaAECDEFGHIJKLMNOPQRSTUVWXYZ[ \ ] 
A _ v abcdef ghi jk 1 mnopqrstuywxyz< | )'•'% 



$ > HK\<iWi'><h'i i l,tth<i<i'S ! "JtSX^ Q*+, -. £0 1 23456789: ; < = >?igflBCBEFGHI -TKLMNOPQRSTUVUXYZCv ] 
A s abcdefghijk1mnopqrstuviAixvz< | j^S 



Bi^^'r6l l iiEi%"Tlf>flFfc 



frfrlA'S'-jVltSr^E.^frlf'^ ! "#*:a y O* + , -..-- 3153456789: ; < = >?@flECDEFGHIJKLMHOPGiRSTUVWXYZCM 
'•^abcdef ghi jk 1 mnopqrstuvwxyz< | }'"^ 

V. \ I' D. £-. b-. l>. "?. \. £.=..? v. *- h- !.- K- \ 






*4"L I k'£ 1 S t !i'SS,%^| l %^ijiiis% AiGGAgd' s '""e6£ Aa o 5cFmidS£S§o>ae6uae6uae6uae6ufli0IIai0sAiOU£ V 
13 

DflNISH/NORWEGIflN SET 

! "#$!:&' <)* + ,-. •8123456789: ; < = >?@flBCIiEFGHIJKLriNOPQRSTUVWXYZ(E0fl-_ ,1 abcdef ghi jk 1 mno 
pqrstuywxyraoa'"^ 

EUROPEAN EXTENDED SET 
klbii&ld' t6t Aa°gc,Nn i .iBfiainVaeoCiaeouaeduaeoCiAi SIEai oafl i 0U£ V 13 

FRENCH SET 
! "#*!£«,' O*+,-./0 123456789: ;< O?aflBCDEFGHIJKLMN0PQRSTUVWXYZ r -'c ]■'-_" abcdefgh ijk 1 mno 

pqrstuvuxyieije' $ 

GERMAN SET 

! "#*!!«.'<)*+,-. •0123456789: ; < =>?@ABCDEFGHI JKLMNOPGJRSTUVWXYZflOU-^' 1 abcdef ghi jk 1 mno 
pqrstuMwxyzaoul3$ 

KATHKANfl SET 
p r j v ■ =?7-f •5i*t>j3'ip-7-f0i^J) ; f ^tDtfiJ^tvgf^f ^+;7?, | l1t^^iti?=.i;y€1'l^ : 7 l ;l^^^ , 7j■■'" 

SPANISH SET 

! "#*^8< '0*+, -.•01 23456789: ; < = >?<?AECDEFGH I JKLMNOPQRSTUVWXYZ i Ni°_" abcdef ghi jk 1 mno 
pqrstuMwxyz <?>>*§ 



SWEDISH^FINNISH SET 

! "#&>.&' <>*+,-. •0123456789: ; <=>?efiBCDEFGH I JKLMHOPQRSTUVWXYZflGAU^ abcdef gh i jk 1 mno 
pqrst uuwxyzaoauS 

UNITED KINGDOM SET 

! "£*5ie.'0*+,-. •0123456789: ; < = >?i?AECDEFGHI JKLMNOPQRSTUVWXYZC\] -_' abcdef ghi jk 1 mno 
pqrstuuuxyz< | >*8 




DDD i ■irjQoi 

I.DDDI I 
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Disc Drive Tests 

The 82901/2 and 9885_9895 tests each perform a write and read test on specified disc drives. 
The tests assume an 82901/2 or 9895 is connected via HP-IB. A 9885 Disc Drive must be 
connected via a 98622 Option 002 GPIO Interface. A 98620A DMA Card must also be in- 
stalled. 

An optional-parameter menu allows you to specify each drive to be tested. Move the display- 
ed arrow to each drive number and press Choose params (kO or k5). When selection is com- 
plete, press k1 or k6. 

Be sure to switch the drive on and load an initialized, unprotected disc in each drive to be 
tested. Close each door and start the test. 

The test first checks for an initialized, unprotected disc. If the disc contains user files, a prompt 
allows you to proceed with the test (erasing all data on the disc) or load another disc. 



CAUTION 

THIS TEST ERASES ALL DATA ON THE DISC. DO NOT USE A 
DISC CONTAINING USEFUL INFORMATION. 

Test running times are generaly less than 5 minutes and depend on the disc interleave factor 
(explained in the programming manual). 
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Mainframe Diagnostics 

A copy of the computer service tests (called diagnostics) are provided with each system. These 
tests are used by HP customer engineers to troubleshoot and align the computer. You may wish 
to run the tests in an automatic mode to verify your computer's operation. 

The mainframe diagnostics test these computer elements: 

• Processor 

• Read-only memory 

• RAM (user memory) 

• CRT 

• Keyboard 

• Internal disc drive(s) 

• CRT graphics 

To load and run the mainframe diagnostics: 

1. Switch the computer off. 

2. Insert System Test Disc 3, Mainframe Diagnostics, into the right-hand disc drive. Close 
the door. 

3. Switch the computer on. The diagnostic is automatically loaded and run after the compu- 
ter self-test is performed. 

These messages are displayed: 

MEMORY TEST IN PROGRESS 



internal tests 



nnnnnnn AVAILABLE BYTES 
982BA TESTS Reu, B 
BOOT REM n 
ROM @ 16Kb: 000000 



RAM @ memory sizes and addresses 

PF : option 

(various displays, some flashing, used 
for service alignment) 

(keyboard diagram, as explained below) 

PASSn 



loading diagnostics 

(or 9B36 TESTS Rev. B) 



testing read-only memory - 
additional ROM sizes and 
addresses displayed if a ROM 
based language system is in- 
stalled. 

test user memory 

(if powerfail option is installed) 



These messages appear 
while diagnostics are 
loading from disc. 



completion of all tests n times 
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If messages other than those described above or below appear, jot them down and call your HP 
customer engineer. This alternate message may appear: 

DRY n t NO DISC DR NOT RDY Disc not in the 9836 left-hand drive. To fully test 

the drive, insert a disc having an ASCII-type file 
named TROMDATA which is at least 80 records 
long. This message also appears if the System 
Test Disc is removed during testing. (Note that the 
disc is accessed during testing). 



A diagram of the keyboard appears after the display tests, allowing you to test each key. To test 
keys, first press any key when the diagram appears. Then press each key and verify that the 
corresponding displayed box toggles on and off. To test the cursor wheel, rotate it and watch 
the box at the bottom of the screen. 

The diagnostic will automatically exit the keyboard test one minute after the last key is pressed. 
You can also exit the test immediately by pressing: 



( CTRL ) ( kp ) 

The PASS n message indicates successful completion of t he tests. The y are automatically 
repeated until you either switch the computer off or press ( SHIFT) (PAUSE) . Only the PASS n 
message should be repeated with each successive pass of the tests. 



Note 
The diagnostics display all values of n using hexidecimals (1 thru 9 
and A thru F). 

Pressing ( SHIFT ) (PAUSE) enters a test mode allowing the service technician to run individu al tests 
or alignment patterns. The test mode redefines the keyboard to enter test codes (keys ( to ) 
thru ( kg ) ). Other keys p roduce test tones. To cancel the test mode and resume automatic 
testing, press ( SHIFT ) ( to ) . 

For instructions on using the test mode, refer to chapter 5 of the 9826/9836 Computer Service 
Manual. 
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Chapter A 
Getting Started 



Introduction 

This chapter introduces many of the computer's operating features, including the keyboard 
functions, display-control keys, arithmetic operations and printer controls. Whether you plan 
to run prerecorded (canned) programs or develop your own, first take a few moments to get 
acquainted with the computer by reading the next few pages. 

Durability is a built-in feature of this easy-to-operate computer, so don't be afraid to test it. 
After reading each section and trying the examples shown, try your own examples. Experi- 
ment. You cannot damage the computer by pressing the wrong keys. The worst that can 
happen is an error message will appear. 

9826 or 9836? 

There are several obvious differences between the 9826A and the 9836A desktop computers as 
you can see in the following illustration. Since the two machines do have several differences, 
such as dual disc drives and an 80-column wide CRT on the 9836, you may be writing a 
program which you want to run on either machine. The machine function is provided to deter- 
mine which computer you are using. You may want to take advantage of this function to decide 
on how you write to the CRT, whether you are going to access the extra disc drive in the 9836 
and other similar operations. For details on the machine function, see Chapter 4. 

Daily Powcr-up 

After the computer has been installed as covered in Chapter 1, daily power-up is simply a 
matter of either switching the power on (if the language system is built-in) or inserting the 
System Disc and switching power on (if your system is soft-loaded). In either case, the compu- 
ter automatically tests its memory and then loads its language system. 

When "HPL READY" is displayed, for example, the computer is ready to accept keyboard 
commands. Now you can load and run programs or develop your own HPL language prog- 
rams. If you're running pre-recorded programs, you may be able to let the computer auto- 
matically load and run a program by using the Autostart feature. 

Program Autostart 

You can have the computer automatically load and start running a program named 
AUTOSTH by inserting the disc in the disc drive before switching the computer on. 
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At power-on, the computer always checks for a disc in its drive. If a disc is inserted, the 
computer looks for a program file named AUTOSTH. If the AUTOSTH file is not found, the 
system searches for file named T0F000, and loads and runs it if present. This emulates tape 
cartridge autostarting. If the right file isn't on the disc, the computer simply displays the HPL 
READY message and awaits your command. 

If your system is soft-loaded at power-up (700-series options), the autostart disc must have 
both the SYSTM-type file and an autostart file to automatically load and run both the lan- 
guage system and a program. 



Computer Operating Features 




(T) Easy-to-use Keyboard. The keyboard is arranged into logical groups for your conveni- 
ence: character-entry keyboard, number-entry pad, display controls, system command keys, 
and program-defined keys called special function keys. 

(7) An Organized Display. The display is partitioned into defined areas for maximum 
useability. One area, for example, is reserved for entering and executing keyboard com- 
mands, as shown later. 

(?) Graphics Display. The display can be set to either of two modes, normal alpha or 
graphics. The computer automatically sets the graphics mode under program control to dis- 
play bar charts, x-y plots, etc. 

© Mini Disc Mass Storage. The built-in disc drive uses standard 130mm (5-1/4 inch) discs 
for storing data, programs and other computer information. Each disc can hold about 1/4 
million bytes (characters) of information. 

© Standard HP-IB Interface. A Hewlett-Packard Interface Bus (HP-IB) is built into the 
computer, allowing direct connection of up to 14 compatible instruments (printers, voltmeters, 
etc.). The programming language for controlling devices via the HP-IB is also built-in, allow- 
ing a program to control instrumentation systems and allows you to easily direct printouts, 
program listings, and displayed graphics to a printer or plotter via the bus. 

Expandable Memory and Interfacing. In addition to the standard HP-IB connector, the 



© 



computer has eight interfacing connectors on its backplane. Each connector can accept a 
memory board (for additional user memory), a language sysem board (for the operating sys- 
tem and add-on language ROMs) or an interface card. As explained in chapter 1, however, 
interface cards cannot be installed in adjacent connectors. 
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Display Organization 

The built-in display (CRT) on the 9826 has a 50-character wide by 25-line work area and on 
the 9836 a 80-character wide by 25-line work area. The HPL language system partitions the 
display into five areas: 



Output Area 

J Blank Line 

V Display Line 

V Keyboard Area (two lines) 

V Message/Results Line 

\ Special Function Key Labels (two lines) 




The Run Screen Format 

The output area can hold 90 or more lines of information, although only 18 lines appear on 
the display. Results of some keyboard and program output appear in this area. When the 
18-line area is filled, the top lines scroll off into a buffer (holding) area of memory. To view 
these lines, use the cursor-control keys and the cursor wheel to scroll through the page. When 
the entire output area is filled, each new line entered causes a line to be lost off the top of the 
buffer. 




Output Area 



18 Lines 



90 Lines 
(user definable) 



The Output Display Area and Buffer 
The display line is reserved for instructions (prompts) from a program to the operator. 
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The k eyboard area is where you enter responses to program prompts or type in commands. 
Press ( CLR LN ] to clear the keyboard area. Now do a simple arithmetic problem: 



Type: 98 + 2G 



Press: ( EXECUTE ) 



The operation is first entered in the keyboard 
entry area. When executed, the result, 124.00, 
replaces the operation in the message/results 
line. 



9B + 2G 




124,00 



Now try repeating the operation. Press ( RECALL ) and ( EXECUTE ) . 

The results of keyboard operations always appear in the message/ results line. The results of 
some keyboard commands, however, like cat (cataloging a disc), appear in the display's out- 
put area. 

The special function key labels area is reserved for labels which appear when one or more 
of the special function keys (kO thru 1(9) are defined. A program displays these labels when the 
special function keys are defined, as explained later. 

The run indicator tells you what state the computer is currently in. When the indicator is 
blank, the computer is free and awaiting your command. 

The arrow in the left-hand corner indicates the currently set direction of the cursor wheel, 
either up-and-down or left-and-right. Use the wheel with the cursor-control keys to rapidly 
position the display cursor. 

Graphics Mode 

In addition to the normal alpha mode, the display has a graphics mode for presenting charts, 
drawings and other pictorial representations. The graphics mode can be automatically set when 
a program outputs graphic data on the display. You can switch back and forth, between 
graphics and alpha modes, by using the GRAPHICS and ALPHA keys. 
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Keyboard Operations 



The computer keyboard is arranged into functional groups for your convenience: 

System Keys 



Rotary 
Control Knob Special Function Keys 



Cursor 
Controls 



Editing 
Keys 




HQDQDCZD L^ZIOZI r^nn^nr 



DISPLAY DUMP DUMP 



GRAPHICS cna« 



C 



DU^JLj-J czdiio 



r^nr^n r 



BDCDCDCDCOCDCDlIlDQQai _ 
EDDEJEJEODDDDEJEKDn ED 



EEDGEJEJEJEOEJEJEJEJED 
[ 1 



( ii > 

8 || 9 



Character Entry Keys 



Program 
Controls 



Numeric Pad 




Character Entry Keys 

The character-entry keys are arranged like a typewriter, but have some added features. 



You can enter the standard upper-case and lower-case letters using the SHIFT key 
to access the alternate case. 

The CAPS LOCK key sets the unshifted keyboard to either upper case or lower case 
(for normal typewriter operation). The computer displays the mode set when you 
press the key. 

The ENTER key has two functions: When a program is running, press ENTER to 
input data requested by the program. When a progam isn't running, the program- 
mer uses ENTER to store each line of program code. 




I ENTER I 

ED 

□ 

I CTRL I 



The TAB key is the HPL assignment operator key, "— >", as is the shift of the ( ] ] , 



The CTRL (control) key works like SHIFT to access a set of standard computer- 
control characters, such as line feed ( L F ) and form feed ( f f). These characters are 
useful to the programmer for controlling some devices and when communicating 
with other computers. 
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Numeric Pad 

\ I V ~ 



□DOE 
□EE1D 



The numeric pad provides a convenient way to quickly enter numbers 
and perform arithmetic operations. Once each arithmetic problem (ex- 
pression) is typed in, press the EXECUTE key to calculate and display the 
result. Note that the | and V characters are generated using the shift of the 
( ( ) and ( ) ) keys, respectively. 



For more details and example arithmetic problems, see Arithmetic Operations later in the 
chapter. 

Cursor Controls 

The curso r-cont rol keys move the display cursor one space at a time . Pres s and 
( <- ) or ( -> ) to move the cursor to the end of the line. The ( t ) and ( I ) 
r~r-inr-| keys allow you to scroll information in the displayed output area up and down. 



1 




I BACK 1 
I SPACE J 



The BACK SPACE key works identically to the ( <- ) cursor control key and is used 
to move the cursor 1 character back in the line. 



The cursor wheel allows you to rapidly move the cursor up and down or 
back and forth, depending on the position of the little arrow in the lower- 
left of the display. You can change directi on by p ressing the an appropri- 
ate cursor-control key, ( <- ) , ( -> ) or ( | ) , ( I ) . Another way to 
change direction is by pressing SHIFT while rotating the knob. 

Take a few moments to move the cursor around using the keys and the wheel. Notice that the 
computer automatically sets the direction of the cursor-wheel arrow after some operations. 




Editing Lines 



CED 



The editing keys put easy character and line editing at your fingertips. 



EHE3EE3 [=3 



I ..si. | Sets the insert-line mode, similar to the insert-character mode. Press INS LN again to 
cancel insert-line mode (edit mode only). 

I m l« | Deletes the line containing the cursor (edit mode only). If a line is deleted, it is stored 
in the recall buffer and can be recalled by pressing RECALL. 

1 »"»"■ I Recalls the last line entered or executed. Pressing repeatedly recalls up to 10 previous 
entries. Pressing shift-RECALL moves forward through this recall buffer. 

I '"""■ I Sets the insert mode, allowing you to insert characters to the left of the cursor. Press 
INS CHR again to cancel the insert mode. 

I ° a c "" I Deletes the character under the cursor. 
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|clr^e. p | Clears the end of the line, starting from the cursor position. Press shift-CLR->END to 
clear the beginning of the line, starting with the cursor position. 

CLR SCR 

r^rg Clears the entire line. Press shift-CLR LN to clear the entire display screen. 

I Em | Enters the edit command, allowing the programmer to use an editing mode for 
entering and editing program lines. (This is like the 9825 FETCH key). 

When a program is in computer memory, the program editing mode displays the 
program lines and waits for the programmer to scroll through, line by line, using the 
cursor wheel and cursor-control keys. Program changes are made by editing each 
line and pressing ENTER. 

To exit the program edit mode, press the PAUSE key. Edit mode is automatically 
exited when RUN, CLR SCR, or any other operation accessing the run screen 
pringing area is executed. 



0: aclr isclr 

1: P50 16isol 1 i400 tl i300ipen« i 

2: csiz G 

3: for 1=30 to 91 

4: for J = 250 to 251 

5: pit IiJilbl "Display proSram" 

6: next J ! n e x t I 

7: csiz 6 _ 



8: 
9: 
10 
11 
12 
13 



for 1=10 to 11 

for J=80 to Bl 
; pit I tJilbl "Alternate 
i next Jinext I 
i 1*P 
i p B n» -P-»P 



e d i t i n 3 line' 




Example Display During Program Edit Mode 

(Replace-Line Edit Screen) 
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0: aclr isclr 

1: psc lGiscl 1 >400 »1 i300 jpen* 1 

2: osiz G 

3: for 1=90 to 91 

4: for J=250 to 251 

5: pit ItJilbl "Display proSram" 

G : next J i n e x t I 



7: cs iz 6 

9: for 1=10 to 11 

9: for J =80 to 81 

10: pit ItJilbl "Alternate editing line 

11: next Jinext I 

12: 1-»P 

13: pen* -P-»P 



t 



Example Display During Program Edit Mode 

(Insert-Line Edit Screen) 
An Editing Exercise 

Now let's qui ckly ty p e in a few lines and go back to make some corrections. To first clear the 
screen, press ( SHIFT ) ( CLR LN ) . 



Here's our first try: 



UsiriS the edittinS Keys m a K e s correcting lines of 
text as esy as pie* 




Original 9826 Line 

Not bad, we only misspelle d one word in the first line "edirting". Move the cursor to the extra 
"t" in "editting" using the ( <- ) and ( -> ) and the knob; then press ( DEL CHR ) once. 

The s econd line needs a character added to "esy". First move the cursor to the "s" in "esy", 
press ( INS CHR ) and insert the missing "a". To cancel the insert mode, press ( INS CHR ) once 
again. 



U s i n 3 the editinS Keys inaKes correcting lines o 1 
text as easy as pie, 



t 




Corrected 9826 Line 
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Please notice that this is only a practice exercise. You can't EXECUTE or ENTER the lines; the 
computer wouldn't recognize them as either a command or a program line. It would, howev- 
er, beep and display an error message. Go ahead and try it: it won't be the last time you'll 
hear that beep! 



System Control Keys 



GRAPHICS CHUB 



ALPHA I I GRAPHICS 



I EmI I 



shift- 1 



The keys in the upper-right corner control various system functions re- 
lated to the display, printer and editing operations. Most of these keys 
execute their functions immediately, as the key is pressed. 



Enters the edit command. The programmer uses the edit mode when entering 
and editing programs. 

Sets a display-functions mode, allowing you to see special control characters such 
as line feed (If) and carriage return (cr) in the display output area. Press shift-EDIT 
again to cancel the display-functions mode. A complete set of display-functions 
characters is shown in the ASCII table at the back of this manual. 



| alpha I These keys allow you to view either one or both of the display modes, normal 

alpha or graphics. For example, if a program sets the graphics mode and outputs 

r"""" 05 ] a g ra phics display, you can return to the alpha mode by pressing ALPHA. You can 

later return to the graphics mode by pressing GRAPHICS. 

Pressing ALPHA or GRAPHICS once sets that mode but doesn't reset the other 
mode. Pressing the key a second time resets the other mode. So you can view 
both display modes simultaneously if you wish. 

SZ Enters the a dump command. Pressing EXECUTE causes the complete alpha dis- 
shift- 1 * m ' I play to be output to the current prtsc device. See chapter 4 for details. 

g«°ap«s Enters the 3d ump command. Pressing EXECUTE causes the graphics display to be 
Shift- 1 graphics | ou tput to the current prtsc device. See chapter 4 for details. 



L 



1 Allows the programmer to step through a program, one line at a time. Using STEP 

to debug programs is covered in the 9825 Operating & Programming Reference 
manual. 



shift- 1 



Shows each available display character. First press shift-STEP. Then enter any 
three-digit number from 000 thru 255. The computer automatically displays the 
equivalent character. The programmer uses this function when developing prog- 
rams. A table of characters and their decimal values is in the ASCII table at the 
back of this manual. 



I CLP. LM J 



Clears the display input line and the message/result line. 



CL " SCR Clears the entire alpha display, including the input line and the scrolling buffer, 
Shift- 1 CLB - J anc i turns on key labels. 
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| RESULT ] 



I PRT ALL j 



shift- 



Enters res, for the result function. Whe n execute d, returns the result of the last 
expression executed. For example, press ( CLR LN ) . Then enter: 



23 + 45 ( EXECUTE ) 



68 ♦00 




Now return the result to the keyboard line and add 123 to it: 

191 ,00 



( RESULT 1 + 123 ( EXECUTE") 



t 




Toggles the printall mode on or off, allowing keyboard op erations a nd displayed 
error messages to be copied to the system printer. Press ( PRT ALL ) once to set 
printall ON and again to set printall OFF. Since the display is automatically set as 
the system printer at powerup, the printall mode can be used to log all keyboard 
operations in the display's output area. Setting the system printer is explained in 
chapter 4. 

Halts program execution after the current line is executed, as is the case for the 
PAUSE key. To re-start the program, press RUN. 



Special Function Keys 

U^JI k - j H DlilJLjuJ The ten keys labeled kO through k9 are Special Function Keys. These 

may be defined and labeled by the operator as typing aids, immedi- 
' '" J " - "' ate execute keys, or immediate continue keys. They may also be 

defined from a program. 

Another twenty special function keys (without displayed labels) can be defined at the same 
time. k10 through k19 are accessed using the SHIFT key and k20 through k29 are accessed using 
the CTRL key. 

Also two additional keys, k30 and k31 can be defined only with the Define SFK Statement (sfk). 
To access k30 or k31, the press keyboard (pkbd) statement is used. Both of these statements are 
described in detail elsewhere in this manual. 



Labelled Special Function Keys 

When a special function key is defined, a label can be assigned to that key as a part of the 
key's definition. Key labels are displayed on the bottom two lines of the CRT, in positions 
corresponding to the associated special function key. 

To include a label as part of a special function key's definition, type the desired text (up to 10 
characters on the 9826 and 16 on the 9836) within quotes, followed by a colon, followed by the 
remainder of the key definition. Some examples will help to clarify this: 
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Press: ( EDIT ) ( ki ) 

Type: "Lab e 1 " : d e f i n i t i o n 

Press: (ENTER) 

Notice that Label is now the "soft" key label assiciated with k1. 
Other labelled special function key examples: 



"Recover" ; * c o n t "Restart" 

"Abo rt " :*sf 3 30 5% "Set shutdown f la a" 

"LoSE base" :/Z. 7 1828182846 

Since the computer can offer a wide selection of operations with each set of defined special 
function keys, the set of key labels is often called a menu. Here's one of the menus available 
with the System Test program: 



System Test Program 
Revision 2-21-81 



Do you want to loS errors on an external printer? 




nncrir^ nnr^n 



rm nr~inrr~in^~i r^~i 
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Immediate Execute Special Function Keys 

If a line to be stored under a special function key is preceded by an asterisk(*), it is an 
immediate execute key. This means that when the key is pressed, the contents of the key are 
appended to the display and the line in the display is executed automatically. 

For example: 

Press: ( EDIT ) [ k ) Accesses k3. 

Type: *prt" " tit The asterisk makes this an immediate ex- 

ecute key. 

Press: [ENTER] This stores the line entered in the display 

under k3. 

Whenever ( k3 ) is pressed and the display is clear, the following is printed: 

3, 14 

Immediate execute keys are useful for executing selected segments of a program. Using the 
continue command followed by a line number, you can make several entry points in your 
programs. For example: 

[ k2 ) :*cont 5 

( lq ) :*cont 10 

Each time ( te ] is pressed, the program continues at line 5, or at line 10 if ( lq ) is pressed. 



Immediate Continue Special Function Keys 

If a line to be stored as a special function key is preceded by a slash (/), it is an immediate 
continue key for use with the enter statement. "Immediate continue" means that when the 
key is pressed, the contents of the key are appended to the display and continue is executed 
automatically. Immediate continue keys are used to enter often used values in enter state- 
ments. For example: 



Press: ( EDIT ) ( k3 ) Fetches special function key k3. 

Type: /2.71B2B1B2846 This enters the value of e, the base of the 

natural logarithms, into the display. 

Press: (ENTER) This stores the line in the display under k3. 

Whenever an enter statement is waiting for a value and the ( k3 ) key is pressed, the 
approximate value for e (i.e., 2.71828182846) is entered and the program continues. 
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Keys with Multiple Statements 

By separating statements with semicolons, several statements can be stored under one special 
function key. As an example, suppose you want t o convert inches to centimetres. The follow- 
ing line is stored under special function key ( te ) . 



Press: ( EDiT ) ( k 2 ) 

Type: *->R 5 dspR , " in . = " >2 . 54R , " cm , " 



Press: (ENTER) 



Then key in a number, such as 6, and press ( te ) . The display will show: 



B.OOin . = 15,24 cm. 




Extended Control Special Function Keys 

If a special function key definition is preceded by an EOL character (decimal 127: use the 
(ANY CHAR) key), it is an extended control key. This means that when the key is depressed, the 
contents of the key are effectively "pushed" on the keyboard. If the key definition is standard 
alphanumeric characters, the se are " typed" in to the displa y. However, the key definitions can 
also be control keys such as ( <- ) , ( INS CHR ) , and (ENTER) . These keys are accessed by press- 
ing CTRL and the command key simultaneously. This allows you to define some very power- 
ful special function keys. For example, the following key is a labeled "Comment" key, useful 
when editing programs: 



Press: ( EDIT ) ( ki ) 

Type: "Comment " : 

ANY CHA R 

Press: ( SHIFT ) ( STEP ) 

Type: 127 



Press: ( CTRL ) ( SHIFT ) ( -> ) 



Press: ( CTRL ) (CLR*END) 



Press: ( CTRL ] ( SHIFT ) ( <- ) 



Press: ( CTRL ] ( INS CHR ) 
Type: X" 



Access SFK 1 

Label it as a "comment" key 

Any char of 127 is theEOL char 

Home right 

Take out of insert-character mode. 

Home left key 

Insert character mode 

Percent symbol, first quote 
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Press: ( CTRL ) (SHIFT) ( -» ) Home right key 

Type: " Second quote 



Press: ( CTRL ) [ENTER] Store key 



Press: (ENTER) Key Defined! 

Now, any text typed on the keyboard can be entered as a comment line by pressing special 
function key k1 , or " C o m m e n t " . 

Default Special Function Keys 

There are several special function keys predefined by the 9826A HPL Language system. The 
meanings and use of these keys are discussed in this section. Note that although several keys 
are predefined at power-up and whenever s f k (with no parameters) is executed, they may 
be defined by the user at any time with the EDIT key and the sfk statement. 



r e QT) This is an immediate execute key that is appended to the FRONT of the 

keyboard line which is then executed. Typically, this key would be used to 
resave a program by first pressing k5 (the save key), typing in the program 
name between the quotes, then pressing k1 to resave the program. 

Press: ( te ) Displays: save " " with insert cursor 

Type: NAME Now looks like: save "NAME" 



Press: ( kp ) Now looks like: resave "NAME" 

Automatically executes resave "NAME" 

find CjED This is a typing-aid key that displays find " " on the keyboard line, 

with an insert cursor between the quotes. The characters that you want to search 
the program for go inside the quotes. 

♦ list ( te ) This is an immediate execute key that lists the program in memory to the 

current system printer. 

* c a t ( k4 ) This is an immediate execute key that catalogs the system disc (set by 

msi or drive) to the current system printer. 



save ( te ) This is a typing-aid key that displays save"" on the keyboard line, 

with an insert cursor between the quotes. The file name of the program to be 
saved is then typed (and goes between the quotes). When EXECUTE is pressed, 
the program in memory is saved to the current system disc drive (set by msi or 
drive). 



set CMZ) This is a typing-aid key that displays Set"" on the keyboard line, with 

an insert cursor between the quotes. The file name of the program to be 
loaded is then typed (and goes between the quotes). When EXECUTE is pressed, 
the specified program is loaded into memory (if one exists on the disc). 
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nis i CJO This is a typing-aid key that displays ms i " : " on the keyboard line, 

with an insert cursor between the colon and the second quote. The mass stor- 
age unit specifier is then typed (and goes between the colon and the quote). 
When EXECUTE is pressed, the disc specified becomes the system mass storage 
device. 

list CjT) This is a typing-aid key that displays list on the keyboard line. Its 

use is essentially the same as the LIST key was on the 9825A. 

e rase CKD This is a typing-aid key that displays erase on the keyboard line. Its 

use is essentially the same as the ERASE key was on the 9825A. 

Program Control Keys 

The PAUSE, RUN, CONTINUE and CLR I/O keys allow you to control execution of the program 
stored in the computer's memory. 



■ RUN 1 

I PAUSE I 

I CONTINUE I 



Starts program execution from the beginning. 

Pauses program execution after the current line, returning computer control to 
the keyboard. 

Resumes program execution from where it was paused, or enters data for an 
active ent or enp statement. 



^Z^m Stops program execution immediately without erasing the program or data mem- 
shift- f p»us E 1 ory. The HPL READY message indicates that the computer is ready for your 
•— ■■ ^ command. This is the equivalent of the 9825 RESET key 

^L_ Stops program execution after the current line, as by pressing the PAUSE key. 
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Arithmetic Operations 



The arithmetic operators are located within the numeric keypad. Their operations are listed in 
the arithmetic hierarchy of HPL. 

sqr or V Square root (shift of ( ) ) ) 

Exponeniation 
no operator Implied multiplication 

*/ Multiplication and division 
H — Addition and subtraction 

If you prefer, you can also use the same characters found within the typewriter keyboard. 

To perfo rm arithmetic operations, first clear the di splay's " keyboard" area by pressing 
( CLR LN ) . Then simply type-in the problem and press ( EXECUTE ] . Try these examples: 

First, how many characters can be entered into the 9826 computer's complete 50-character line 
by 18-line by 5-page alpha-display area? 



Enter: 50*18*5 
Press: ( EXECUTE ) 



50*18*5 
4500,00 



(characters) 




If you spend 3% of your time today reading this manual, how much of your eight-hour 
workday is left for work? 



Enter: 8-8* ,03 



Press: ( EXECUTE ) 



8-8*, 03 

7,78 

t 



(hours left) 




If the floor in your office is square, with each side measuring 6.2 metres, how many square 
metres of carpeting are needed to cover it? You can either multiply 6.2 * 6.2, or you can find 
the square of 6.2 by raising it to the second power (6.2 f 2): 



Enter: 8,2-2 ( EXECUTE ) 



B . 2 '• 2 



(square metres) 
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Notice, in each case, that the computer displays the result in the lin e below w here you entered 
the problem. This allows you to either recall the problem (press ( RECALL ) ) and compare it 
with the result, or recall the result (press ( RESULT ) ) and use it as part of another problem. For 
example: 



Enter: 98 + 26 ( EXECUTE ) 



Enter: 25* ( RESULT ) 



Press: ( EXECUTE ) 



Enter: ( RESULT ) 121 



Press: ( EXECUTE ) 



I 

I 



124,00 

25* res 

3100.00 

re s/37 

83.78 

% 
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Chapter O 
Program Transfer 



Introduction 

This section addresses a major concern of 9825 owners and programmers, namely, how to get 
9825 programs and data into the 9826 or 9836. There are two approaches possible: one, 
simply save the 9825 programs and data on a 9885 or 9895 disc, then reconnect the disc drive 
to the 9826/9836 Computer and read the programs and data in. This approach is a natural for 
those users already using the disc extensively. The second approach uses I/O to transfer 
programs and data, and requires a bit more coordination between the two computers (and 
work on your part). The best interface to use to avoid complications from losing data is the 
HP-IB interface, which is internal to the 9826/9836 and is the 98034 interface card for the 
9825. 



Disc Transfer 

The 9885 and 9895 discs offer the simplest means of transferring programs and data from the 
9825 to the 9826/9836 (and vice-versa, if desired). In addition, disc file transfers offer the only 
method of transferring key files from the 9825 to the 9826/9836. Once the disc drive is installed 
on the 9826/9836, the same commands that were used on the 9825 can be used. For example, 
to load a 9825 program "Progl" into the 9826/9836 (from a 9885 disc, unit number at select 
code 8), the following statements could be used: 

d r i u e » 8 
Set "Prosi" 

The above sequence can be shortened by using the new mass storage unit specifier (msus) 
available on the 9826 and 9836: 

Set "Prosl sF8 >0" 

Disc data files can be accessed in the same manner as from the 9825, using the same program 
statements. One additional statement may need to be added to your programs if they assume 
default drive parameters of unit number 0, select code 8. On the 9826 and 9836, to access an 
external disc drive (9885 or 9895), a drive or msi statement must be executed explicitly stating 
the unit number and select code of the disc drive. (The default drive on the 9826 is the internal 
minifloppy and the internal drive on the right side on the 9836.) 

There are additional disc programming capabilities offered by the 9826/9836: you may wish to 
refer to Chapter 4 of this manual for specific details of these disc programming enhancements. 
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Interface Transfer 

Interface transfers offer a means of getting programs and data from a tape-based 9825 system 
into the 9826 or 9836. The concept is fairly straightforward, and there are just a few minor 
details to take care of to implement the transfer. To keep matters simple, the example presented 
assumes an HP-IB interface for the transfer operation. 

Programs 

The actual operation is a simple list * 731 of the program from the 9825, and a short 
program on the 9826/9836 that reads in the program and stores it into memory. You then save 
the program on the internal minifloppy disc drive of the 9826 or 9836. 

The first step of the process is to connect the two desktops together and power them up. The 
9825 requires the 98034 interface, which is connected to the built-in HP-IB interface of the 
9826/9836. The 98034 is assumed here to be set at factory default switch settings: most 
importantly System Controller and bus address 21. 

From the 9825, execute pet 731 to pass controller functions to a non-existent bus device. 
This makes disassembly and reassembly of the 98034 unnecessary. 

Now from the 9826/9836 execute w t c 7 , 30 to change the bus address of the 9826/9836 so 
there won't be a conflict with the 9825's bus address. (Both have bus addresses of 21, unless 
the hardware switch settings from the factory have been changed. ) 

On the 9825, load in the desired program (for example, t rK 1 5 ldf 8). On the 9826/9836 
RUN the following program: 

0: "Loader" : dim A$[B5] 5nal->N i721-»S 

1: "input" : red S .A$ i if 1 en ( A$ )< = 2 i St o "input" 

2: if A$E 1 ,1 ] = "*" isto "done" 

3: "store" :on err "error" istore A$ trial 

H i 3 1 o "input" 

5: "error":"J,"ift$-»A$iSto "store" ,,,, ' 

G: "done":red S , A$ t A$ » A$ tnal->K A .' ^ 7 

7: prt "Record the program on the desired track and file" 

8: prt "(or file n a m e ) i from line N throush line X." 

9: prt "For example) 'trKlircf BiNiX't Then delete the" 

10: prt "old proSram and re-run this p r o S r a m for the" 

11: prt "next pros ram to be transferred, "ifxd 

12: prt "To delete the sawed proSramt use ' d e 1 " t N . " . " . X > " ' " 

13: end 

*17G13 

On the 9825, execute list **73 1 . The 9825 program is now transferred. 
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Data 

Now that you have seen the program transfer process, you must consider the data transfer 
process. The machine set-up for data transfers is identical to that used to transfer programs, but 
now you need a program in each machine. The programs must be specifically tailored for the 
particular data files to be transferred. A simple example here will illustrate the concept. The task 
is to transfer ten 3000 character string files from the 9825 tape to the 9826/9836 internal disc. 
The string files will be saved as tape files on the 9826 or 9836 disc for maximum simplicity. 

9825 Program 

0: dim A$[3000]i!?, "This line chanSes according to '/our own data structure" 

1: trK lifor 1=0 to Oil "ASaint modify according to your data structure" 

2: ldf I »A*iwrt 73i .A* 

3: next Iiprt "Transfer c omp 1 e t e . " i end 

9826/9836 Program 

0: dim A$E3000 J i% "This line must be identical to the S825 program line 0" 

1: trk lifor 1=0 to Oil "fliaim this must aJree with 9825 proSram aboue" 

2: red 721iA*ircf IiA$i7. "This line is the only one different" 

3: next Iiprt "Transfer compl e t e . " i end 

Both programs are essentially the same except that line 2 of each is suited to the particular 
function that is being performed: the 9825 is taking data from the tape and sending it to the 
9826/9836; the 9826/9836 is reading in the data from the 9825 and saving it on the disc. 
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Chapter 4 
HPL Programming 



Introduction 

This section summarizes the enhancements and differences between the HPL 2.0 operating 
system and the 9825 HPL language. Organization is presented by 9825 ROM function so that 
you can easily understand new material in relationship to the 9825. 
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Mainframe Programming 

The Read, Data, and Restore Statements 

To assign constant values to string and numeric program variables, the data and read 
statements can be used. 

data string or numeric constant [ * string or numeric constant]... 
read variable name [ » variable name]... 
rst r [label] 

The data statement provides string and numeric constant values to be assigned to program 
variables. String constants may be quoted or unquoted. Each constant is separated from the 
next by a comma. The read statement assigns the constants provided by data statements to 
variables in the read statement variable list, one constant per variable. As each constant is 
read from the data list, the data pointer is positioned to the next constant in the data list. This 
data pointer can be reset either to the first data statement occurring in the program or to the 
specified line label by using the restore statement, r s t r. A short example will help clarify this 
concept: 

0: dim A$[20] 

1: data 100 »" item 1 " »200 > " i t em 2">300i"item 3" 

2: "line 2":data 400i"item 4 " .500 . " i t em 5"iG00»"item 6" 

3: data 700t"item 7" t800 t " i tem 8"i900."item 3" 

4: for 1 = 1 to 9iread X.A$»prt X .ft* 

5: if I=Girstr "line 2" 

G: next Iiend 

Press: RUN 

100.00 item 1 

200.00 item 2 

300.00 item 3 

400.00 item 4 

500.00 item 5 

GOO. 00 item G 

400.00 item 4 

500.00 item 5 

GOO. 00 item G 

Note that after the sixth data item pair was read, the rstr statement was used to reset the data 
pointer to " 1 i in e 2 " , data item 4. If line 5 of the program is changed to 

5: if I=Gi rst r 

the printout looks like this: 

100.00 item 1 

200.00 item 2 

300.00 item 3 

400.00 item 4 

500.00 item 5 

BOO. 00 item G 

100.00 item 1 

200,00 item 2 

300.00 item 3 

The data pointer was reset all the way back to the first line of the program, which meant that 
the next data item read was data item 1 on line 1. 
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The Programmable Beep Statement (0&Pp3 16) 

pbeep [frequency [ t duration]] 

This statement drives the internal beeper with a programmable frequency and duration. 
Allowable frequencies range from Hz through 5167 Hz. The frequency is taken as a mod- 
ulus of 81.23 Hz, which means it is "rounded" to the nearest multiple of 81.23 Hz. Allowable 
durations range from through 2.56 seconds. The number of seconds duration is rounded to 
the nearest hundredth of a second, (.01 sec). 

The Machine Function 

w a c h i n e 

This function returns a value that characterizes the internal configuration of the computer. 

bit (Oi machine) = 80 column alpha (9836A) 

1 = 50 column alpha (9826A) 

bit ( 1 . m a c h i n e ) = 400x300 pixel graphics (9826A) 

1 = 512x390 pixel graphics (9836A) 

bit ( 2 f wachine)0 = CRT has no highlights (9826A) 

1 = CRT has highlights (9836A) 

bit (3* machine) = machine has a keyboard 

1 = machine has no keyboard 

The first three of these examples can be used to determine if the computer currently in use is a 
9826A or 9836A. The fourth is not currently implemented in hardware. 
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CRT Display Control (O&P p. 3 16) 

The Clear Alpha Statement 

ac 1 r [number of scrolling pages] 

The a c 1 r statement clears the alpha screen and optionally assigns the number of scrolling 
pages for the scrolling buffer. If not specified, the number of scrolling pages selected is left 
unchanged from the previous value (four at power-up). 

On the 9826A, 900 bytes (18 lines of 50 characters) of read-write memory is used for each 
scrolling page. On the 9836A, 2880 bytes are used per scrolling page. The reason that so much 
more memory is used is because two bytes are reserved for each character cell; 1 byte for 
character and 1 byte for the highlight (e.g. blinking, see crt statement). This means that 18 lines 
of 80 characters per line times 2 bytes per displayed character is used — or 2880 bytes of 
memory. 

The following program line sizes the scrolling buffer according to the amount of memory 
remaining, leaving enough room (1800 bytes or more) for most stack operations. Remember, 
large string operations require that enough memory be available for the operation! 

aum/ (900b it (0 ^machine )+2S80( 1-bit (0 machine ) ) ) 

When aclr is executed: 

• the graphics screen is unaffected 

• key labels are displayed 

• the RUN screen format of the CRT is selected as opposed to the Edit screen 

• Display Functions is turned off 

Highlighting on 9836 

crt value 

The crt statement is used to control the video highlight scrolling capabilities on the 9836A 
CRT only. 

The following values are used: 

- inverse video 

1 — blinking 

2 - underlining 

3 - half-bright 

These values set the corresponding bit of the highlight byte (see aclr statement) to provide the 
desired alpha highlighting. 
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The Alpha On, Alpha Off Statements 



aoff 
a on 



The aoff statement turns off the alpha display without affecting the contents of alpha mem- 
ory. When an a o n statement is executed, the alpha screen is displayed. All screen operations 
(prt, dsp) function normally whether the display is turned on or off. Key labels (SFK labels) 
are not affected - see the K 1 o f f and K 1 o n statements. 
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The Key Labels On/Off Statements 

K 1 o f f 
K 1 o n 

The K 1 o f f statement turns off the display of special function key labels. The contents of the 
labels are not affected, so that executing a K 1 o n statement causes the original labels to be 
displayed. (Note that the s f K statement - Systems Programming - can be used to define 
SFK's labels from a program.) 

The Dump Alpha Statement 

a dump [select code or buffer[ > number of lines]] 

The ad urn p statement sends the specified number of alpha display lines to the desired select 
code or buffer. If no parameters are specified, the first 18 lines of the alpha screen are sent to 
the system printer (prtsc device). 

The Tab X-Y Statement 

t a b x y column t row 

The t ab x y statement directs CRT printing (and reading!) operations to the character and line 
position of the screen as specified by the "column" (character) and "row" (line) parameters. 
The column parameter must be within the range of through 49 on the 9826 and through 79 
on the 9836. The row parameter should be within the range of through 17. Specifying a row 
greater than 17 causes the row parameter to be truncated to 17 (you cannot tab below the 
bottom of the screen). Column 0, row is the top left-hand corner of the CRT. 

The Read CRT Statements 

red i B[ . format number] > variable list 
rdb ( IB)-*- variable 

Data can be read from the CRT in much the same manner as from an external device. Data is 
taken from the CRT at the present cursor position and assigned to variables in the variable list 
according to any formatting in effect. Read binary (rdb) operations from the CRT operate in 
the same manner as for external devices. 



Note 

There are no "hidden" control characters on the screen. Unless 
"Display Functions" is on, control characters such as carriage- 
return and line-feed are not part of the CRT data. Also, reading 
past the end of scrolling memory simply returns blanks (decimal 
32). 
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The System Printer Select Code Statement 

prtsc select code or buffer[ twidth] 

This statement directs all print operations to the specified select code or buffer. This affects 
statements such as p r t , tlist, aprt, spc, listk, cat, I i s t , and also directs PRINT 
ALL messages. The optional "width" parameter determines the number of characters to be 
printed before a carriage-return/line-feed is sent by the aprt and listk statements. Power- 
up default for p r t s c is to the CRT, width = 50 on the 9826 and width = 80 on the 9836. 
(No, execution prtsc IBtBO will not cause 80 character lines to be displayed on the 9826 
CRT, and prtsc 1 B * i B will not emulate the 9825 strip printer!) 



Math Functions (O&P p. 3-22) 

s q r expression 
Returns the square root of a non-negative expression. Identical to the V operator. 

p i 
Returns the value of pi (it). Identical to the tt function. 



Flags (O&P p. 3-28) 

There are 32 program flags available, numbered through 31. Flags through 15 are ident- 
ical to 9825 program flags, with special meanings for flags 13, 14, and 15. Flags 16 through 
31 are strictly user program flags, not affected by the system. 



The Cross Reference Statement (O&P p. 4 32) 

The x r e f statement now lists references to p-numbers. 

The Find Statement 

f i n d string expression [ dine number! [ dine number 2 ]] 

To list all of the lines that contain the specified character string, the find statement is used. 
The list of these program lines is output to the current prtsc device. 

If no line numbers are given, the entire program is searched. If a single line number is given, the 
program beginning from the specified line to the end of the program is searched. If both line 
numbers are given, the range of program lines is searched. 
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The search is not done on the line number nor the colon that follows the line number but does 
include the space following the colon. 

To search for quotes, be sure to follow the double quote convention. For example to find all 
lines that contain a label you could execute: 

find "A""" 

where the A character represents a blank. The doubled quotes will be considered a single 
quote. 

At execution time, this must be the last statement in the line. 

Tape Cartridge Operations (O&P chapter 5) 

A program utilizing tape cartridge mass storage operations will in general be able to run unmod- 
ified on an HPL 2.0 operating system. However, do not try to insert your tape cartridge into the 
disc drive! 

The actual method used to implement tape operations on a disc is to create files on the disc 
that correspond to 9825 marked tape files. This is done automatically by the operating sys- 
tem: you don't have to worry about how to do it. However, this has some implications that 
you should be aware of. 

• You can do tape operations to any disc drive supported by HPL 2.0: 9885, 9895, 8290x, 
and the internal minifloppy drives. Tape operations are directed to the current disc drive, 
set by drive or msi (see Disc Programming). 

• The files accessed by the tape statements are more or less ordinary disc files which have 
been named according to a special convention. This convention was established so that 
given a track number and file number, the file name is uniquely defined. The convention 
is: 

TxFyyy 

where x is a single-digit track number, or 1 and y is a three-digit file number, 000 to 
999. An example tape file name, track file 15 is: 

TOF015 

• Three new disc file types have been created to allow tape statement emulation. These 
new types are: 

NULL (tape file-type 0): file with current size of 
NBDATA (tape file-type 2): file with numeric data 
SBDATA (tape file-type 3): file with string or mixed data 

• The mrk and ert statements do not initialize the disc media, rather they simply create and 
purge disc files on an initialized disc. Therefore, an uninitialized disc must first be initial- 
ized (with an i n i t statement) before the tape files can be marked. 

• The format for a tlist printout has been modified to take advantage of the new 50 charac- 
ter line width of the CRT. A tlist now indicates the secured/unsecured status (scd) of the 
program, and the file type is now listed as a mnemonic rather than a number. 
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Track# Secured Program Current msi Device 

Indicator 



\ 



File* 



trK 1 / wsi " :I »0" 

file scd type (#) our.size abs_size 



<«0 * PROGRM (B) 432 512 

#1 KEYS (5) 4G 25G 

«2 NBDATA (2) 304 512 

#3 NULL (0) V C> 



\ \ 



File Type Mnemonic File Type Number Current File Size Absolute File Size 

(same as value returned by idf) (bytes) (bytes) 

• Disc files are always sized as a multiple of 256 bytes per record. Thus, any tape file will 
necessarily have to be rounded up to a multiple of 256 bytes, even if you specify it to be 
less. (For instance, although you executed "mrk 1,50", you actually got one file of 256 
bytes. ) 

• Due to the increased memory size of the 9826 and 9836, recording strings ( r c f N t A * ) 
requires two extra bytes overhead per string on a file. Usually, this will cause no problem 
for an old 9825 program being run on a 9826/9836, because all files on the 9826/9836 
are rounded up to a multiple of 256 bytes. 

• A 1 1 i s t will list only tape files of the tape file-name convention, and they will be listed 
in order by file number, regardless of their order in the disc directory. 

• A cat (catalog) of the disc will list both tape files and disc files. The order of the file 
names in the directory is unimportant. Both tape and disc files are allowed on the same 
disc. 

• Auto-verify (avd, ave) affects only tape statements, as expected. Verify (von, voff) affects 
only disc statements. Defaults at power-on, reset, and erase a, are ave and voff. These 
are identical to the 9825 defaults. 

• Record and load memory (rem, 1dm) are not implemented in HPL 2.0. (Imagine rem on a 
4 megabyte machine!) 

• Disc statements can access files created with tape statements (mrk) and tape statements 
can access files created with disc statements provided they conform to the tape file-name 
conventions listed above. 



Note 

It is highly recommended that only tape statements be used to ac- 
cess tape files and only disc statements be used to access disc files! 
There are a number of subtle points affecting file access that must 
be considered, as described above. If you wish to mix statement 
and file types between tape and disc operations, it is suggested that 
you do so on non-critical data at first, until you feel confident that 
you understand the interactions! Refer to the discussion on "Binary 
Data File Support" in the "Disc Programming Technical Appendix" 
at the back of this manual for more details on tape files on disc. 
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Record Binary Statement 

r c b file number 

The record binary statement stores the binary program in memory onto the specified tape file. 
The file number is any numeric expression, and if ommitted file is assumed. 



String Variables 

Value Function (O&Pp. 6-17) 

v a 1 ( string expression [ tbase] ) 

By specifying an optional second parameter "base", string expressions representing numbers 
of any base (2 thru 36 inclusive) can be converted to base 10. 

String Function (O&P p. 6 19) 

str ( numeric expression! *base] ) 

By specifying an optional second parameter, "base", numeric expressions can be converted 
from base 10 to a string expression representing a number in any other base (2 thru 36 
inclusive). 

Examples: ual < "FF" » 16) — -A A = 255 

str(lOfZ) — «~A$ A$ = "1010" 

Read Statement (O&P p. 6 32) 

The general I/O red statement now allows substrings as data destination variables. 
Example: red 3 »B$C 15 ,250] 
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Systems Programming 

Intelligent Terminal Instructions (0&Pp.7-7) 

Additional capabilities for program emulation of intelligent terminals are provided by the HPL 
2.0 Language system. In addition to program response to keypresses, the program can also 
respond to rotation of the Rotary Control Knob. 

The On Knob Statement 

on Knob [label »[rate]] 

Kret 

This statement zeroes the knob-count, then enables program interrupts from the Rotary Con- 
trol Knob. Whenever the knob is rotated, the knob-count accumulates at a rate of 120 units 
per revolution and an end-of-line branch to the on-knob service routine is taken. The 
accumulated knob-count can be accessed via the knob function, which indicates both direc- 
tion and amount of rotation. The on-knob service routine can also access the status of the 
( CTRL ) and ( SHIFT ) keys (for shifted-knob and control-knob functions) via the K s t a t function. 
The on-knob service routine exits with the Kret statement, which returns control back to the 
main program. 

The rate is an optional parameter that specifies the number of seconds between knob inter- 
rupts. The legal range is from 0.01 (default) to 2.56 seconds. The default value of 0.01 seconds 
is also set when a program is not running. When a program is resumed, the previous set rate is 
again used. 

The Knob Function 

K n a b 

The Knob function returns the accumulated count of the RPG (Rotary Pulse Generator), or 
knob count, indicating both direction and degree of rotation. The knob count is approximately 
120 units per revolution, or three degrees per unit count. This is an approximate count, suitable 
for relative positioning information only. (Counts may be missed when the knob is spun very 
rapidly.) 

Negative values for K n o b indicate counter-clockwise rotation. Positive values for K n o b indi- 
cate clockwise rotation. 
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The Knob Status Function 

K s t a t 

The k s t a t function returns an 8-bit knob status. This is a self-zeroing function that zeroes 
when read and is set when an on-knob end-of-line branch is taken. 

The meanings assigned to k s t a t bits are as follows: 



Most Significant Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


1 


1 




Shift 














Control 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Bits 0-3: Always zero 

Bit 4: Zero if ( SHIFT ) is pressed 

Bit 5: Zero if ( CTRL) is pressed 

Bit 6: Always one. 

Bit 7: Always one 



The k stat function is useful in determining whether the user is pressing the ( SHIR ) or the 
( CTRL) key while rotating the knob. Your program could then perform an alternate function 
for the knob's rotation. 

The Key Buffer Empty Function 

key 



The key function is essentially unchanged from the 9825 key function, in that it returns 
unprocessed keycodes. The k e y function now returns 9826/9836 hardware key codes, but the 
a s c function can be used to obtain the ASCII codes for keys. These ASCII keycodes are 
identical for all HPL computers. For example, the hardware keycode for "5" on the 9825 
numeric keypad is 83 while on the 9836 the same key has a code of 2885. On both computers, 
however, the ASCII code is 53. 

If your programs depend on the 9825 hardware keycodes, they will have to be converted to 
function correctly with the new 9826 keycodes. Refer to the Keycode Conversion Table for the 
corresponding values of 9825 and 9826 keys, or you can use the keycode conversion utility 
function "9825 key" supplied with the HPL Utility Programs to achieve program compatibility. 
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Serial Interface Control (O&P p. 7 14) 

The Remote Keyboard Statement 

rk b d select code [ ttype] 

The r k b d statement operates in an identical fashion to the 9825 r k b d statement except that 
the type remote keyboard now requires 9826/9836 keycodes. Note that the type 1 remote 
keyboard (ASCII) operates the same for both machines. 

For power-up remote keyboard operations, there is a jumper on the 98626A Interface that 
must be cut (as with the 98036A). Refer to the 98626A interface diagram in the 98626A 
Installation manual for the location of the remote keyboard jumper. 

The Press Keyboard Statement 

p k b d [string expression] 

The press-keyboard statement effectively "pushes" keys on the keyboard, exactly as if the 
human operator were pressing those keys. System control keys are pressed by putting their 
ASCII value in the press-key string. For example, a decimal 10 character (line-feed) is the 
character for the EXECUTE key, and has the effect of executing previous characers in the string. 
The statement 

p k b d " 5*2 l f " results in a display of 1 . 00. 

p k b d "5*2" & c h a r i 1 ) results in the same display. 

The EDIT A$ statement in BASIC can be simulated in HPL using pkbd A$ 5 era A$. The 
string in A$ will be placed in the keyboard line. Any modifications that need to be made can be 
done using the editing keys. Then when all corrections have been made, press ( CONTINUE ) . 

The pkbd statement has several potential uses. One use is to give the user "live keyboard" 
capability even though a running program has an "on key" service in effect. Now, instead of 
having to write a complete interpreter within the program to implement "live keyboard," the 
program merely has to p k b d those ASCII keycodes that need to be executed by the system. 
For example, to emulate a full live keyboard with a running program: 



: on Key "sue" 

1: Sto +0 

2: "sue": if not (asc key-»K)!Kret 

3: if KslipKbd char(K)ikret 

li : end 

♦ 3629 



Set up service routine 

Loop 

Test for and exit if empty buffer 

Else "push" key and exit unless 

PAUSE key was pressed: stop. 
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Another example of pkbd is to access special function keys 30 and 31 after having defined them 
using the s f k statement. As an interesting exercise, check the default definitions of these keys. 

Type: pkbd" Enter pkbd with opening quote. 

ANY CHA R 
Press: shift- ( STEP ) Define the ASCII key code for sfk 30. 

Type: 158 

Type: " Close the quotes. 



Now press ( EXECUTE ) 
The display shows the version of HPL: 
(RAH) HPL 2.0 READY 

The Define SFK Statement 

s f k[key number[ »definition string[ tlabel string]]] 

The sfk statement allows special function keys to be defined from a program. Keys can be 
labelled with the optional label string, and defined to be any valid key sequence with the 
optional definition string. 

s f k 9 erases the definition for SFK#9 

sfk erases all key definitions; replaces them with their de- 

fault settings 

s f k 8 f " w r t 705 » " defines key #8 to be the string "wrt 705," 

sfk 3 t"HELL0 JIM" >" LOGON" defines key #3 to be labelled a log-on key sequence 

for a terminal emulator 

The length of the definition string plus the label string must not exceed 77 characters. Specify- 
ing a definition string only (with no label string) allows 80 characters of definition. 

The ASCII value "of special function keys on the keyboard range from 128 (kO) through 159 
(k31), and can be defined by the program using sfk and "pressed" by the program using 
pkbd. The following example extends the live keyboard emulator to allow you to type control 
characters on the keyboard (CTRL A for example) and not have them be executed as control 
keys. With the previous example, CTRL A effectively executed a PAUSE. With this example, an 
ASCII " s h" character is displayed, just as if there were no program running. 

: on Key "sue" 

1 : Sto 1 

2: "bud": as c (key*A)->K 

3: if bit<9»A)=0 and KOZisfK 31 > c ha r ( K ) i pK b d cha r ( 1 59 ) ! k ret 

IX: pkbd char(K)!Rrst 

5 : en d 
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Systems Programming Instructions (O&Pp. 7 21) 

The System Boot Statement 

sysboot [ " file name " ] 

The svsboot statement allows you to "boot" or start up any ROM or soft operating system, 
including a re-booting of the current system. Omitting the file name parameter causes the 
current operating system to be reloaded and initialized. 

Specifying a file name of one character followed by a null character (ANY CHR of 000) will 
cause the soft system file name "SYSTEM_x" to be booted from the internal minifloppy, if 
the system file is present. (The character "x" of the system file name is the same character 
specified in the svsboot statement.) If no disc is present with the "SYSTEM- " file on it, the 
ROM operating system "x" will be booted and initialized. 

Example: svsboot " B N u " Boot BASIC ROM language system (if BASIC soft 



(null) 



system is not present) 



svsboot "SYSTEM_B" Boot BASIC soft system 

Matrix Programming 

Array Output (Matrix p.8) 

ap rt array variable[ >array variable]... 

The array print statement prints the elements of an array to the system printer. The rightmost 
subscript now increments most rapidly. This is different from array prints for the 9825, which 
incremented the leftmost subscript most rapidly. In addition, a p r t now utilizes the full width 
of the printer to print the array: the printed array is no longer formatted as if it were being 
printed to the 9825' s strip printer. 
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Disc Programming 



In general, disc operations in HPL 2.0 operate identically to 9825 disc operations. Howev- 
er, there are some optional extensions to the Disc Programming Syntax that allow you to 
access some additional disc drive types and some new capabilities (such as having diffe- 
rent file pointers on different disc controllers, and accessing tape files on disc). 

If you are familiar with disc programming, reading this section should give you enough 
information to utilize the new disc programming capabilities. If you should need more 
information about performance or implementation, refer to the Disc Programming Tech- 
nical Appendix at the back of this manual. 

If you are not familiar with disc programming, you should first read the 9825 Disc Prog- 
ramming Manual, then refer to this section for information regarding the extensions made 
to HPL 2.0 disc programming. 

The Mass Storage Unit Specifier 

A mass storage unit specifier, or msus, is a string expression giving a formal description of the 
mass storage device being accessed: 

1. The device and format being used; 

2. The device select code (and bus address, if applicable); 

3. The device unit number. 

The following table summarizes mass storage unit specifier parameters. 

Device Format Table 



Device 


Disc Type 


Disc Format 


Select Code 


HP-IB 


Default 


Unit Number 


Format 






Range 


Address 


Select Code 


Range 


Specifier 








Range 


Value 




I 


Internal 


LIF 1 


- 


_ 


_ 


(or 1 on 9836) 


M 


8290x 


LIF 1 


1-15 


0-7 


700 


0-3 


F 


9885 


9825 Compatible 


l-15(not 7) 


- 


8 


0-3 


G 


9885 


LIF' 


l-15(not 7) 


- 


8 


0-3 


H 


9895 


9825 Compatible 


1-15 


0-7 


707 


0-3 


J 


9895 


LIF 1 


1-15 


0-7 


707 


0-3 



1 LIF: Hewlett-Packard Logical Interchange Format: File type ASCII is compatible with 9826/9836 BASIC language ASCII files and with HP 
2642A Terminal files. 
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The format for a mass storage unit specifier (msus) is: 

: [device format [select code]] [ *unit number] 

Normally, only the device format need be given. Each device format specifier has a default 
select code and unit number. However, certain critical statements require you to specify all 
the msus parameters due to the potentially destructive effect of those statements (in it, 
k i 1 1 a 1 1 and disc copy). 

The select code parameter must consist of 1 to 4 digits only. The unit number parameter must 
consist of a single digit only. Plus or minus signs, periods, or "e" are not allowed. This means 
that if functions such as the str function are used to generate the desired string expression, 
fxdO or equivalent must be in effect. 

Note that when specifying the internal drive as the mass storage device, there is no associated 
select code, so that parameter is omitted. Some examples help clarify the msus concept: 

; F8 »0 Specifies 9885 disc, 9825-compatible format, select code 8, unit number 0. 

: I Specifies internal disc drive. 

: J707 1 2 Specifies 9895 disc, LIF format, select code 707, unit number 2. 

:H *3 Specifies 9895 disc, 9825-compatible format, default select code for "H", 

unit number 3. 
s > 2 Specifies current device format and select code, unit number 2. 

The msus is allowed as an extension to a file name parameter as shown in the following 
examples: 

as an "Datal:H707»3" tl 
asSn "DataZ: I" »2 
kill "01dprosf:F8 »1" 

All disc programming statements except the files statement that use the "file name" para- 
meter can now use the "msus" parameter appended to the file name. 
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The Mass Storage Is Statement 

There is a new statement, nisi, added to the Disc Programming Syntax to allow you to 
specify the current mass storage device (as was accomplished with the d r i u e statement on 
the 9825) with a mass storage unit specifier (msus). This allows access not only to 9825- 
compatible discs, but also to LIF discs. The syntax is: 

fti s i [msus] 

where msus can be any suitable string expression that conforms to the format already defined. 
Executing msi with a specified msus will set the value of the current default msus (current 
drive and format). That value will remain in effect until it is explicitly changed with another 
msi or drive statement, or until a power-up, reset, or erase a occurs. 

Executing msi with no parameter will restore the power-up default msus of " : I " for the 
internal minifloppy. 

Some examples of the msi statement follow: 

'flsi Restore power-up default (" : I " for internal 

drive) 

f x d ! " : J "-HI* ; 707-H3 5 2-^U Set mass storage device to 9895 disc select code 

msi M$6:st p(S)8c" i"tst r (U) 707, unit number two, LIF format. 



The Assign Statement (Disc Programming p. 3-5) 

as 9"n file name t file number [ tunit number [ » return variable]] 

The assign statement has been extended to allow you to include the msus with the file name 
in order to completely define the characteristics of the file and drive. When the msus exten- 
sion is being used and the return variable is given in order to obtain file status, you can specify 
a "unit number" of -1 which prevents overriding the msus unit number. This becomes, in 
effect, a "place holder" in the parameter list. An example illustrates this: 

asjfr. "Dataf ile:H701 i3" »G i-l »X 

This assigns file number 6 to file "Datafile" on a 9895 disc, 9825-compatible format, control- 
ler address 701, unit number 3. The -1 unit number is a place holder, and X is the return 
variable for the file status. 

as aim "Dataf i le :H701 »3" *B t0 *)< 

This statement has all the same effects as the one above, except that now unit number is 
selected, overriding the msus unit number of 3. 
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The Drive Statement (Disc Programming p. 1-14) 

The drive statement is essentially unchanged from its 9825 definition except that file pointers 
are no longer cleared if the select code is specified. However, the select code range for a 9885 
disc is now 1-6 and 8-15. (Select code 7 is reserved for the internal HP-IB.) Note that you 
cannot direct disc operations to an LIF format disc by using the drive statement. The drive 
statement can be used to change just the current unit number leaving other specifications 
unchanged. This can be done regardless of the current device format in effect, even if it is an 
LIF disc. 

The Initialize Statement (Disc Programming p.4-3) 

i n i t unit number » select code [ interleave factor] 

or 

i n i t complete msus [ interleave factor [ » number of directory records] 

The initialize statement can be used as a strictly 9825-compatible statement as shown in the 
first syntax. Only 9885 and 9895 discs of 9825-compatible formats (F and H formats) can be 
initialized when the first syntax version of i n i t is used. 

The second syntax shown for the i n i t statement allows the complete range of 9826 HPL 
supported discs and formats to be specified, as per the "msus" specifier. 

With either version of the i n i t statement, the complete disc drive msus specifications MUST 
be given. This information is always printed on the first line of a catalog listing of a disc for 
future reference. 

Allowable interleave factors are 1-15 for 5-1/4" minifloppy discs, and 1-29 for 8" discs. The 
default interleave factor for a given disc drive yields the best performance possible under a 
wide range of conditions. However, in certain cases,you can increase the performance of the 
disc system by specifying a different interleave factor (but if you go below the recommended 
minimum, extremely poor performance may result!). Some of the cases where better perform- 
ance may be obtained by specifying a smaller interleave factor are: 

• Using a DMA card with a 9895 disc drive to obtain better HP-IB transfer rates. 

• Using a disc primarily for backup purposes, and autoverification is disabled (voff). 

• Using a disc primarily for tape operations, and autoverification is disabled (avd). 

• NOT using a disc for large numeric array or large string transfers to TDATA or ASCII file 
types. 

• NOT using a disc for large numbers of random accesses to consecutive records of a 
TDATA type file. 
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Disc Interleave Factors 



Disc Drive 


Default 
Interleave Factor 


Overall Optimum 
Interleave Factor 


Suggested Minimum 
Interleave Factor 1,2 


Internal 

8290x 

9885 

9895 no DMA 

9895 with DMA 


2 

5 
2 
4 
4 


2 
5 
2 

4 
3 


1 

3 3 

1 

3 3 

2 3 



You can now specify on a LIF disc the number of records used to hold the directory. Each 
directory record can hold up to 8 directory entries. The default number of directory records 
for minifloppies (5Va, inch) is 14, or 112 entries. The default for 8 inch floppies is 28 records, 
or 224 entries. 

Those records not used for directory entries are available for programs and data. Depending 
upon your application, you can trade off directory records for data records or vice-versa. If 
you have a great number of small data files, for instance, you may need more than the default 
number of directory records to hold a greater number of directory entries. You can specify 
from 1 to 500 records for the directory depending upon your needs. Normally, the default 
number of directory records will suffice. 

The following table suggests some practical guidelines for selecting a maximum number of 
directory records per disc type to allow one directory entry for each sector (256 bytes). (This 
configuration would be necessary if a data disc needed a maximum number of files of 256 
bytes or less. ) 

Maximum Practical Number of Directory 
Records for LIF Discs 



Media 


# of directory 
records 


# of directory 
entries 


# of user records 


Minifloppy 
9885 

9895 sgl sided 
9895 dbl sided 


118 
210 
244 
500 


944 
1680 
1952 
4000 


936 
1678 
1944 
3998 



Both the default interleave factor and default number of directory records can be selected by 
specifying a parameter of - 1 in the parameter position. For example, 

in it " : J707 ,0" .-i *-l 

1 See considerations listed above. Also, if an internal disc is used primarily as a system disc, the suggested minimum interleave factor may be 
used. 

2 The suggested minimum interleave factor yields the optimum performance obtainable for a given disc, under optimum conditions. This 
must usually be arrived at experimentally, as different programs and access requirements may need larger interleave factors to attain 
maximum performance. 

3 This interleave is efficient only for backup without auto verification. All other operations require an interleave factor at least one higher than 
recommended. 
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The Disc Type Function (Disc Programming p. 1-15) 

d type 

The dtype function now returns a value of 9 for either the internal minifloppy or external 
S290x minifloppy drives. However, the open drive door status returned by dtype is different 
for the two drives. 

Internal drive: status check indicates "disc changed" but not "door open" or "disc present". 
A value of 1 is never returned, and values of 2 and 9 do not guarantee that 
the door is now closed and disc is present. 

8290x drive: status check does not indicate a condition of "door opened", so a value of 2 
is never returned. 
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The Catalog Statement (Disc Programming, p. 1-16) 

HPL 2.0 supports 3 new file types on 9825-compatible discs. All three are related to 9825 tape 
statement emulation. The same file types are also supported on LIF discs. The file type mne- 
monics used in 9825-format disc catalog listings for these new files are: 

Z (NULL) null file - 9825 tape file type 

N (NBDATA) numeric binary data - 9825 tape file type 2 

S (SBDATA) string/mixed binary data - 9825 tape file type 3 

The catalog listing format for 9825-compatible discs is identical to that of the 9825/98228 
ROM combination. Old 9825 programs which do cat's to buffers to access the catalog in- 
formation should have no problem doing the same with 9825-compatible discs on 9826 HPL. 

The catalog listing format for LIF discs, however, is different from the 9825-compatible disc 
catalog listing due to the fact that the 9825-compatible disc catalog listing only has space for 
6-character file names, whereas LIF file names can be up to 10 characters in length. Thus, the 
9825-compatible & LIF catalog listing formats are somewhat different. An example of a LIF 
catalog listing from the 9826 internal minifloppy is shown below: 



MSI " :I»0" 

AVAILABLE RECORDS 1002 

FILE NAME SCD TYPE 



•BYTES 



•RCRDS 


ADDRESS 


10 


IS 


1 


2B 


1 


27 


1 


28 


10 


23 


1 


39 


10 


50 


1 


40 


1 


51 


1 


52 


1 


53 



S r a d e s 

Class 

C o u n t 

Name 

Si ue 

keys 

null_f ile 

secured_pr 

asci i_f i le 

ruime r i c_bd 

stririsf_bd 



TDATA 

PR0GRM 

PR0GRM 

PR0GRM 

TDATA 

KEYS 

NULL 

PR0GRM 

ASCII 

NBDATA 

SBDATA 



9G 
S2 

242 



2 U 



242 

24 
134 



Notes: 



The "complete msus" is given on the msi line. Users may find this useful for reference, since the new alternate 
syntaxes for init, killall, and disc copy require the "complete msus". 

The "SCD" field, following the file name, is used to indicate secured programs. If a "*" is present in this field, 
the program is secured. 

The file address is given as a single logical record address, as opposed to breaking it up into separate logical 
track and sector addresses. 
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The Killall Statement (Disc Programming p. 1-18) 

k i 1 1 a 1 1 unit number > select code 

or 

killall complete msus 

The killall statement can also be used with the full range of HPL 2.0 supported discs and 
formats by specifying the second syntax, which allows the msus specifier. 



The Open Statement (Disc Programming p. 3-2) 

The open statement now allows you to specify the desired type of file when opening a data 

file. The new syntax is shown below. 

o p e r^file name > number of records [ t file type] 

where file type is a string expression having the value "ASCII", "NULL", or "TDATA". 

The open statement in HPL 2.0 can be used to create two new file types besides typed-data 
(TDATA) files. ("TDATA" corresponds to the old 9825 typed-data files, designated by a "D" in 
the catalog listing.) The two new file types supported by HPL 2.0 are "ASCII" and "NULL". 
The default file type is "TDATA". As with "TDATA" files, when an "ASCII" file is created, 
each record of the file is initialized with logical end-of-file marks. The records of "NULL" files, 
however, require no initialization; thus, none is performed. 

"ASCII" files provide compatibility between HPL and other 9826/9836 programming lan- 
guages. "ASCII" data files are also used to provide transportability between the 9826/9836 
and other computers or terminals with LIF ASCII file capability. Their use is identical to that of 
regular data files ("TDATA"), with some exceptions. Technical considerations in the use of 
ASCII files are discussed in the Disc Programming Technical Appendix at the back of this 
manual. 

"NULL" files are essentially unused "tape" emulation data files. Their use from a program- 
ming standpoint is like accessing data files on the 9825 tape cartridge. "NULL" files become 
either "NBDATA" (Numeric Binary Data) files or "SBDATA" (String or Mixed Binary Data 
Files) files when data is stored to the file. These files can be accessed either with tape cartridge 
operations or disc programming operations. Their use with tape cartridge operations (rcf, ldf) 
is discussed under the Tape Cartridge Operations section of this manual and in the Disc 
Programming Technical Appendix. 
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The Disc Copy Statement (Disc Programming p. 4-7) 

copy [source drive number [ > select code] i]"to" 

C t destination drive number [ » select code]] 

The original syntax of the (disc) copy statement with select codes in HPL 2.0 works exactly as it 
did on the 9825; it allows access to 9825-compatible 9885 and 9895 drives. However, if the 
source or destination select code is omitted, the current default device format and select code 
are used in each case, whatever they may be. 

The original syntax of the (disc) copy statement without select codes in HPL 2.0 works like the 
new drive statement: the unit number, if given, modifies only the current default drive number, 
and uses the current default device format and select code, whatever they may be. 

Examples: 

oopy0t8»"to"»l»707 Copy source disc, 9825-compatible 9885, select code 8, 

unit number 0, to destination disc, 9825-compatible 9895, 
select code 707, unit number 1. 

msi ":G"ioopv "to'M Copy source disc, LIF-type 9885, select code 8, unit num- 

ber 0, to destination disc, LIF-type 9885, select code 8, 
unit number 1. 



CAUTION 

EVEN THOUGH THE SYNTAX DOESN'T REQUIRE IT, IT IS 
HIGHLY RECOMMENDED THAT THE COMPLETE INFORMA- 
TION BE EXPLICITLY GIVEN, FOR THE USER'S OWN PRO- 
TECTION, DUE TO THE "SERIOUS" NATURE OF A DISC 
COPY. 



NOTE 

With the 9825/98228 ROM, you were not prevented from doing 
disc copy from a single-sided disc to a double-sided disc, in which 
case the double-sided disc would end up with the same amount of 
user space as the single-sided disc! Due to this unfortunate possibil- 
ity as well as the even worse possibility of copying a minifloppy to a 
double-sided full-sized floppy (resulting in a 75% loss in capacity!), 
a test is performed by the operating system to prohibit disc copies 
between "significantly" different-sized media. If the destination disc 
is 50% larger than the source disc, the copy will not be allowed. 
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New Alternate Syntax for Disc Copy 

copy complete source msus t "to" , complete destination msus 

With the new alternate syntax, all supported device/format specifiers can be accessed. De- 
faults are not allowed in the msus; select code and unit number must be specified EXPLIC- 
ITLY. 

Examples: 

copy " :M700 »0" »"to" * " s I >0" 
copy " 5F8*0" t"to" ,":H707 .0" 

Regardless of the syntax used, disc copies are not allowed from a LIF disc to a 9825- 
compatible disc or vice-versa. 

The File Copy Statement (Disc Programming p. 4-7) 

copy source file name [ t drive number [ » select code]] * 

destination file name [ * drive number [ t select code]] 

In general, almost all HPL files can be copied back and forth between LIF and 9825-compatible 
discs without any problems. There are, however, some complications associated with differ- 
ences between LIF and 9825-compatible discs, which might prevent a file copy from taking 
place. 

1. Invalid file name (error D3): LIF allows up to 10 characters in a file name, while 9825- 
compatible discs only allow up to 6. 

2. Wrong file type (error D6): Some file types supported with LIF are not supported on 
9825-compatible discs. ASCII files are the only HPL-created files with this characteristic. 

3. Directory entry field overflow (error f3): Certain fields in a 9825-type directory entry are 
smaller than their counterparts in a LIF directory entry. This makes a directory entry 
field overflow possible when copying the file from a LIF disc to a 9825-compatible disc. 
The field most likely not to fit is the file size field. 9825-compatible discs cannot support 
files whose size in bytes is greater than 65536. Note that this does not apply to 
"TDATA" files, where the file size field is not used. Also, one field in a LIF directory is 
smaller than its counterpart in a 9825-type directory. This field is guaranteed not to 
overflow when copying an HPL-created 9825-compatible disc to a LIF disc, but with 
9825-compatible files created by other jnainframes, it might. 
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As with all other HPL statements having the "file name" parameter, file copy's "file name" 
parameter has been extended to allow appending an optional msus. However, since the file 
copy syntax supports an optional unit number and select code in addition to the "file name" 
parameter, there may be confusion as to which select code and unit number will take prece- 
dence. The following rules apply: 

1. If the "file name" does not contain an msus, the current default device format, select 
code, and unit number will be used, unless explicitly overridden by the optional unit 
number and select code. If the optional select code parameter is given, 9825- 
compatible 9885/9895 format is implied, the same as for the drive statement. 

2. If the "file name" parameter contains an msus, the optional select code parameter 
(outside the msus) is not allowed. 

3. If the "file name" contains an msus, and the optional unit number parameter (outside 
the msus) is given, it will override the unit number specified or implied by the msus. 

4. The source and destination file names with their optional unit numbers and select codes 
are completely independent, that is, one can contain an msus while the other has the 
optional select code. 

Examples: 

copy " f i 1 e 1 " » " f i 1 e 1 b " 
copy "f ile" tOf "file" »1 
copy " f i 1 e " » 1 8 i " f i 1 e : I " 

The Save Binary Statement 

save b file name 

The save binary statement stores the current binary in memory to the specified disc file. 9825 
binaries and 9826/9836 binaries are in no way compatible. Binaries written for the 9825 are 
processor-dependent and as such would have to be completely re-written to run on the 9826/ 
9836. Because the file types for 9825 and 9826/9836 binaries are identical, a user cannot 
merely look at a catalog listing and determine whether an unknown binary is for a 9825 or for a 
9826/9836; both show up as type "B" on 9825-compatible discs and "BINARY" on LIF discs. 
However, HPL sets a flag in the directory to enable it to distinguish between binaries, so a 
9826/9836 will not attempt to load a 9825 binary. To do so would have completely unpredict- 
able results. The 9825, on the other hand, does not look at the flag, so it will attempt to load a 
9826/9836 binary if directed to do so by the user. This will certainly generate unpredictable 
operation of the 9825. Don't do it! 

The Disc Read and Disc Write Statements 



CAUTION 

USE OF THE d w r t STATEMENT CAN DESTROY THE DATA ON 
A DISC, INCLUDING THE CATALOG. USE WITH CAUTION! 
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d r e d starting logical record # » destination string 
dwrt starting logical record # » source string 

The d r e d and d w r t statements allow reading and writing to logical records on a disc. This is 
an extremely dangerous operation since one accidental write to the directory can destroy the 
disc. The disc must have been previously initialized. All types of strings, string arrays, and 
substrings are allowed with the following rules: 

• The string (if a substring) must start on an even address. 

• The string must specify an even number of bytes. 

• If doing a dred to a string array, the entire array will be filled. 

• If doing a dwrt, and the source string is a string array, every element of the array must be 
full. 

• If you write a number of bytes which is not an even multiple of the record size (256 bytes), 
the unused portion of the last record will contain garbage. 

• dred and dwrt will work on all supported mass storage devices (internal, 9895, 9885, 
8290X). 

Unimplemented Disc Programming Statements 

Four disc statements have not been implemented in HPL 2.0. They can be syntaxed, stored, 
listed, recorded with programs, and loaded with programs. However, any attempt to execute 
one of them will result in error f9 (Statement not implemented). The unimplemented state- 
ments are: 

d u m p 
load 
saue hi 
3 e t m 

Unimplemented 98217 ROM System Cartridge Binary Statements 

HPL 2.0 like the 9825' s 98228 ROM, does not implement the statements contained in the 
binaries on the 98217 ROM's Disc System Cartridge (init and killall are implemented with a 
different syntax). These statements are: 

d t r k 
t i n i t 

It rk 
dire 

boot 

v f v b 

pt rn ts t 

cK rd 

init (implemented with different syntax) 

killall (implemented with different syntax) 
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More I/O 

Interface Control Operations (I/O p.4 14) 

In general, the HPL 2.0 Language System register and interface programming operations 
operate identically to their 9825 counterparts. This is due to an emulation of the 9825 interface 
registers. You should be aware, however, that the 9826/9836 interface hardware is indeed 
different from that of the 9825, and that this prevents a 100% accurate emulation. The follow- 
ing tables list the primary differences between 9825 interface operations and the HPL 2.0 
emulation of those operations. 

Select Code Summary Table 



Select Code 



OREAD 
WRITE 
1 
2 



16 READ 
WRITE 



9825 Source/Destination 



Keyboard (KDP) 
Single line display 
Reserved for tape cartridge 
External 



Keyboard (KDP) 
Internal printer 



9826/9836 Source/Dest. 



Keyboard 

Display line of CRT 

External 



Internal HP-IB 
External 



Read from CRT 
Write to CRT 



Note: 



- Select code 1 of the 9826/9836 is available for external devices 
■ Select code 7 of the 9826/9836 is reserved for internal HP-IB. 

Read from select code 16 does not return keycodes on the 9826/9836, but instead reads data from the CRT print area. 
• Read from select code of the 9826/9836 returns 9826/9836 hardware keycodes, completely unlike 9825 hardware keycodes. 
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9826/9836 Select Codes and 16 



Operation 


Select code 


Select code 16 


rdb 


Wait for keypress, then 
return keycode 


Read a byte from CRT at current 
print position 


red 


Not allowed 


Formatted read from CRT at 
current print position 


wt b 


Write bytes to display line 


Write bytes to CRT at current 
print position 


wrt 


Formatted write to display 
line 


Formatted write to CRT at 
current print position 


rds 


Always returns value of 8 


Always returns value of 8 


wtc 


Select language jumper 
(wtc 0,5 selects Katakana) 


Select language jumper 
(wtc 16,5 selects Katakana) 


wti4 


No operation 


No operation 


wt i5 


No operation 


No operation 


wtiB 


No operation 


No operation 


wt i7 


Select language jumper 


Select language jumper 


rdi (4) 


Always returns value of 


Always returns value of 


rdi(5) 


Always returns value of 8 


Always returns value of 8 


rdi(B) 


Always returns value of 


Always returns value of 


rdi(7) 


Always returns value of 


Always returns value of 



NOTE: 

- wti5 on the 9825 could control features such as insert/replace cursor type, run light on/off, trigger beeper, trigger printer, and 
trigger display. These are not accessible on the 9826/9836. 

- Read and write operations have different effects on 9826/9836 select codes and 16. On the 9825 rdb(0) = rdb(16). 

- rdi(4) on the 9825 reads the hardware keyboard scanner. There is no equivalent on the 9826/9836. 

- wti4 and wti6 on the 9825 wrote bytes to the display and printer buffers. There is no equivalent operation on the 9826/9836. 
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98623A BCD I/O Operations 

For BCD input, operation of the 98623A BCD Interface is identical to its 9825 counterpart, the 
98033A. However, there is also an 8-bit output latch available to the user. This is to be 
considered simply an output latch, with no dedicated handshake lines. Access to the latch is via 
binary operations. For example to latch a byte "N" to a BCD interface on select code 3: 

w t i 1 3 5 w t i 4 » N 

or simply 
w t b 3 » N 

Executing a write-control (wt c) to a BCD interface with the RESET bit set (bit 5 = 1) will reset 
the interface and terminate any active t f r for the interface. 

98622A GPIO Operations 

The 98622A GPIO Interface operates identically to its 9825 counterpart, the 98032A, except 
that now when the invert-data jumper is installed, all data is inverted regardless of the transfer 
type selected. (Recall that the 9825 and 98032A did not invert data for DMA or fast read- 
write transfers, or for register I/O.) Also, a software RESET of the interface now will terminate 
any active t f r to or from the interface. 
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HP-IB Operations 

There are some slight differences between register operations with the internal 98624A HP-IB 
interface and its 9825 counterpart, the 98034. Please note that all high-level operations (wrt, 
red, tfr, pet, etc.) are compatible with 9825 operations! The following table serves to summarize 
HP-IB operations for the 9825 and the 9826/9836. 



HP-IB Operations 



Operation 



rdsfS .AiB.O- 
A 

B 
C 



rds(s) 
w t c S ) X 



rdi4 
rdi5 
rdiG 
rdi7 
wti.4 or B 
u t i 5 
wti7 »X 



10 5 

iof 



9825 Result 



HP-IB Extended Status 


















DCL 





Error 










1 1 | 1 | - HPIB Address - 










EOI 


REN 


SRQ 


ATN 


FC 


ND 
AC 


NR 
FD 


DAV 



9826/9836 Result 



SRQ 


CA 


TA 


LA 


SC 


1 


SPL 


EOI 



Return fourth HP-IB status byte (D, above) 
Not Allowed. 



Immediate read of R4 

Immediate read of R5 

Immediate read of R6 

Immediate read of R7 

Immediate write to R4/R6 

Immediate write to R5 (Not recommended) 

Immediate write to R7 



Return 98034 STS line. 
Return 98034 FLG line 



HP-IB Extended Status 









REM 
LOC 


LLO 


GET 


DCL 


IFC 


Error 



1 | 1 | - HPIB Address - 


EOI REN SRQ 


ATN 


IFC 


ND 
AC 


NR 
FD 


DAV 



- REN, IFC may be incorrect 1 if System 
Controller 

- ATN indicates attempted drive status, not 
actual state of line if Active Controller 

- SRQ may be incorrect 1 if Active Controller 

- EOI may be incorrect 1 if Active Talker 

- NDAC, NRFD may be incorrect 1 if not Active 
Talker or Active Listener 



SRQ CA TA LA SC 1 EOI 



- SRQ reflects current state of SRQ line: this is 
not latched as it was on the 98034 Interface 

- The 98034 SPL bit is now always false on 
the 98624A 

Return fourth HP-IB status byte (D, above) 

If X< = 31, then software reset and 

terminate transfer. If X<31 then HP-IB 

address is set to X. If X = 31 then no further 

action. If X>31 then configure parallel poll 

response: 

Bit 4=1: disable ppoll response 

Bit 4=0: enable ppoll response 

Bits 0-2: define ppoll response line thru 7 

Bit 3=0: "0" true ppoll response 

Bit 3 = 1: "1" true ppoll response 

Always 

Always 

Always 

Always 

Wait for FLG then write to R4/R6 

Same as EIR 

If bit 7 of X=0 then bits 0-7 define serial poll 
response byte. If bit 7 of X= 1 then 

Bit 2 (ATN): 1=TRUE 

Bit 4 (EOI): 1 = enable EOI with next data byte 

Identical operation to 9825, 

If the 9826 HP-IB is addressing or talking to the 
bus then iof = 1 when ready for next data item, 
else iof=0. 



1 These lines are driven from the 9826/9836 in the specified state. However, the actual status of these lines may be different from that indicated 
by simply reading status. (Consider the case of an HP-IB analyzer or a defective instrument forcing a line to a state different from the 
attempted drive state of the 98624A HP-IB interface card.) 
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HP-IB Operations (Cont'd) 



Operation 


9825 Result 


9826/9836 Result 


eir 




SRQ 


CA 


TA 


LA 


Internal 
Use 
Only 


Err 

DCL 

SDC 


EOI 




SRQ 


CA 


TA 


LA 


Internal 
Use 
Only 


IFC 
GET 
DCL 
SDC 


EOI 








1 

t 

1 


SOTE: CA, TA, LA interrupts do NOT wait for ATN 
o go false before triggering! (The 98034A 
liggered these interrupts when ATN went false.) 
"he user service routine should wait for ATN 
alse before accessing the bus. 


t f r (buffer type 5) 


Not allowed 


Byte DMA transfer if DMA card is present. 


tfr701, 1 t "buf " 


Format ignored 


Terminate on EOI. 


tf r701 .2 ,"buf " 


Format ignored 


Do not terminate on EOI. 


tf r"buf ("701 ,1 


Format ignored 


Send EOI with last byte. 


tf r"buf ."701 ,2 


Format ignored 


Do not send EOI. 


Output to non- 
existent device 


Completes. 


Hangs. Card reset is required 
(wtc7,31 or SHIFT PAUSE) 



HP-IB Capability Comparison 

(from the 98034 Installation and Service Manual p. 4) 



98034 


9826/9836 HPL 


SHI (Complete) 


same 


AH1 (Complete) 


same 


T6 (No Talk-only) 


same 


TE0 (No Extended Talker) 


same 


L4 (No Listen-only) 


same 


LEO (No Extended Listener) 


same 


SRI (Complete) 


same 


RL0 (none) 


RL1 (Complete) 


PP2 (Locally configurable only) 


PP1 (Complete) 


DC1 (Complete) 


same 


DT0 (none) 


DTI (Complete) 


Cl,2,3,4,5 


same 


El (Open collector driver) 


E2 (Three-state driver) 
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98626A Serial I/O Operations 

The 98626A RS-232C Interface is nearly identical in operation to the 98036A RS-232 Inter- 
face with the following exceptions: 

• There is a new register, R30UT, that must be set before successful emulation of the 
98036A Interface is possible. If a female RS-232C cable (DCE connector) is present, bit 
of R3 must be set ( = 1). For male cable (DTE connector), R3 bit must be clear ( = 0). 
To enable CTS/DTR line transmitter control (this emulates the 98036A: any device con- 
nected to CTS/ DTR could control the USART transmitter with this line), R3 bit 1 must 
be clear ( = 0). To disable transmitter control, set R3 bit 1 ( = 1). 

R3 0UT 



Most Significant Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


- 


- 


- 


- 


- 


- 


Handshake 


Cable Type 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Bit 0: 1 = Female connector (DCE: Std cable) 

= Male connector (DTE: Opt. 001 cable) 

Bit 1 : = Enable transmitter handshake (CTS/DTR) 

1 = Disable transmitter handshake 



USART Mode Word (R4C) 



Most Significant Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Number of Stop Bits 






Character Length 


98036A Bit 


00 = not valid 


Parity Type 


Parity Enable 


00 = 5 bits 


Rate Factor 


01 = 1 bit 


= Odd 


= Disable 


01 =6 bits 


not used for 


10 = 1.5 bits 


1 = Even 


1 = Enable 


10 = 7 bits 


98626A 


11=2 bits 






11=8 bits 





Bits and 1 (Bit Rate Factor) are ignored. 
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USART Control Word (R4D) 



Most Significant Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Always 


USART 
Reset 


No 
Connect 


Reset Status 
Bits of 
USART 

Status Word 


Send Bread 
Character 


Enable Data 
Receiver 


Data Set 

Ready 

Pin 6(Std.) 


Enable Data 
Transmitter 


Request To 

Send Pin 4 

(Option 001) 


Data 

Terminal 

Ready Pin 20 

(Option 001) 



Same as 98036A, except that bit 5 cannot be used to control the Clear-to-Send line on the 
standard (DCE) cable. Instead, Clear-to-Send is controlled by Request-to-Send of the DTE 
device. 



USART Status Word (R4E) 



Most Significant 


Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


RTS-4 
(Std.) 


Always 


Framing 
Error 


Overrun 
Error 


Parity 
Error 


Transmitter 
Empty 


Receiver 
Ready 


Transmitter 
Ready 


DSR-6 
(Option 001) 



Same as 98036A. 



R6 Registers 



R6 OUT (Opt. 001) 



Most Significant Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


- 


- 


- 


Half/Full 
Speed 


No 
Connect 


No 
Connect 


DSRS 
pin 23 


SRTS 
pin 19 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



R60UT, Opt. 001 (DTE) cable has two no-connects. There is no U.K. Data Signal Rate 
Select (pin 11): bit 2. There is no Special Purpose line (pin 25): bit 3. 
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R6 IN (Opt. 001) 



Most Significant Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


1 


1 


1 


1 


1 


Secondary 
Carrier 
Detect 
pin 12 


Ring 

Indicator 

pin 22 


Data 
Carrier 
Detect 

pin 6 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



- R6IN, Opt. 001 (DTE) cable is unchanged. 

R6 OUT (Standard) 



Most Significant 


Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit© 


- 


- 


- 


Half/Full 
Speed 
Control 


Ring 

Indicator 

pin 22 


No 
Connect 


Secondary 
Carrier 
Detect 
pin 12 


Data 
Carrier 
Detect 

pin 8 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



R60UT, Standard (DCE) cable has one no-connect. There is no Secondary Carrier Detect 
(pin 12): bit 2. Note that Ring Indicator and Data Set Ready (pins 22 and 6) are tied 
together. The last one set will determine the actual line state of both. 

R6 IN (Standard) 



Most Significant 


Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


1 


1 


1 


1 


1 





No 
Connect 


Secondary 

Request 

To Send 

pin 19 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



- R6IN, Standard (DCE) cable has one no-connect. There is no Data Signal Rate Select (pin 
23): bit 1. 
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Internal Clock Access 

The 9826 has a built-in real-time clock that is accessible from HPL for the purposes of keep- 
ing time, reading time, and executing program routines at a set time, periodically, or after a 
programmed delay. The following statements provide the capability to set and read the real 
time. There are several new interrupt control statements provided to enable interrupts from 
the real-time clock. Refer to the following section for the syntaxes of these statements. 

The Set Clock-Time Statement (I/O p. 5-15) 

s t i m e [seconds] 

This statement sets the internal clock to the specified time (in seconds). The resolution of the 
internal clock is .01 seconds, and the range is from zero seconds to 180 years. As an example, 
the following routine sets the internal clock to a value relative to March 1, 1900, taking into 
account leap-years. This format is compatible with BASIC and Pascal language systems. 

0: "Ti mexpl ": 

1: dim T*C80] , XC 12] , H*[ 12, 3] 

2 : ac 1 r 

3: gsb "Set-time" 

4: gsb "Read-time" 

5: dsp T*;gto 4 

24: "Set -time": 

25: prt "Type in 24-hour time and date as:" 

26: prt "Hr <H> , Mi n(N) , Sec (S> " 

27: prt "MonthCM> , Day(D) , Year C V) " 

28: ent H,N,S,M,Ii,Y 

29: if Y>1900; Y-1980*Y 

30: if M>2;M-3*M;gto 32 

31: M+9*M; Y-1*Y 

32: st i me <! i nt C 1461*Y/4) + i nt < i 1 53*M + 2;'.--5> +D)*24*S0*S0+H*3600+H*S0+S 

33: ret 

The s t i m e statement should be executed before any on-match, on-cycle, or on-delay inter- 
rupts are enabled. 

The s t i m e statement is also used to transfer the battery clock time into the internal computer 
clock. (The battery clock is slightly more accurate than the internal computer clock. ) 

The Read Clock-Time Function (I/O p. 5-15) 

rt ime 

This function returns the current number of seconds held by the internal clock. The resolution 
is .01 seconds with a range of zero seconds to 180 years. The following routine displays the 
clock time assumed relative to year 1900: 

38: "Read-time": 

39: data MAR , APR, MAY, JUH, JUL, HUG, SEP, OCT , NOV, DEC, JfiN, FEE 

40: rstr "Read-t i me" ; f or 1 = 1 to 12; read M*[ I ] ; next I 

41: i nt C rt i me > *S ; i nt (. %/ C 24*60*66 ) ;■ *D + Z ; i nt ( I)*4/ 1461) -+Y 

42: D-int '-. 1461*Y.-4 :>-*D- i nt C(D*5-2)/153>+Ms D-i nt < < 153*M + 2J^S")-s-D 

43: if H>9; Y+l+Y 

44: 8-2*24*60*60*3 

45: S-< i nt <S- , 3600)->H)*3600 + S 

46: S-C i nt CS^60)-+Hi*60*S; fxd 

47: str<H)S.": "S : st r< N)S," : ":>,st r CSJ8." , "liMJCM+l ]8.st r i. Did" , "f.-=.t. r C Y+19BM i+Tt 

48: ret 

*29174 
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Interrupt Control (I/O p.5-5) 

The On Interrupt Statement 

on i select code [, label [ * abort byte]] 

The syntax of the o n i statement has been extended to allow the service routine linkage for a 
select code to be cancelled. Executing oni with no service routine label cancels the interrupt 
service routine linkage for that select code. 



Interrupt Lockouts (I/O p. 5-15) 

The 9826 HPL operating system, like the 9825, has certain critical operations that lock out 
interrupts for short periods. Unlike the 9825, however, the 9826 does not lock out interrupts 
for long periods of time during tape drive accesses. (There is no tape drive.) The 9826 is also 
capable of supporting two DMA operations simultaneously; therefore, utilizing one DMA 
channel does not prevent initiation of a second, concurrent DMA transfer. 



The On Clock-Cycle Statement (I/O p. 5-15) 

on cycle [period » label] 

c re t 

This statement first zeroes the internal clock cycle count, then enables a periodic (cyclic) 
interrupt from the internal clock of the 9826. The minimum period allowable is 10 mil- 
liseconds (.01 second) and the maximum period allowed is one day minus 10 milliseconds 
(24*60*60 -.01). The "label" parameter specifies the line label of the on-cycle service 
routine. The on-cycle service routine will be executed every "period" number of seconds as a 
result of an end-of-line branch, and must eventually terminate with a c r e t statement. The 
on-cycle service routine must access the current clock-cycle count via the cycle function, 
described next. The on-cycle routine cannot be exited (via cret) until after the cycle function 
has been executed! Executing o n cycle with no parameters disables on-cycle interrupt ser- 
vice. 



The Cycle Function 

The cycle function returns the number of clock-cycles that have occurred since the last- 
executed on cycle statement or cycle function. (The on cycle statement and the cycle function 
zero the clock-cycle count.) The cycle function can be executed by the user program at any 
time to read the current cycle count, but it (cycle) MUST be executed within an on-cycle 
service routine before cret will allow a return to the main program. 
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The On Clock-Delay Statement (I/O p. 5-15) 

on d e 1 a v [wait t label] 

d re t 

This statement enables a "wait" clock interrupt from the internal clock of the 9826. Once 
on delay is executed, the internal clock starts counting down the "wait" number of 
seconds specified (0.1 sec to 24*60*60 - .01 sec) until it reaches zero. At that time an end-of- 
line branch is taken to the on-delay service routine specified by the "label" parameter. The 
on-delay service routine must terminate with a dret statement to return to the main 
program. 

Executing the on-delay statement with no parameters disables pending on-delay interrupts 
and service. 



The On Clock-Match Statement (I/O p. 5 15) 

on match [alarm time » label] 

m r e t 

This statement establishes an "alarm" time interrupt for the internal clock of the 9826. Once 
the on match statement is executed, the internal clock checks for a match between the "alarm 
time" and the current time. When the two times match, an end-of-line branch is taken to the 
on-match service routine specified by the "label" parameter. The on-match service routine 
returns to the main program via the m r e t statement. 

The allowable range of the "alarm time" is .01 seconds to 24*60*60 -.01 seconds (.01 
seconds less than one day). Executing on-match with no parameters disables any pending 
match interrupt and service. 
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Buffered I/O 

Terminating I/O Transfers (I/O p. 6-9) 

An I/O transfer in progress to or from a select code can be aborted by resetting the interface: 
GPIO-type transfer: wt c select code t 32 
HP-IB type transfer: w t c select code t 3 1 



I/O Buffer Extended Status (I/O p. 6-11) 

The r d s function can return optional parameters regarding buffer status. The syntax for 
extended buffer status is: 

rds< buffer name [» type [ > empty [ * fill [ tdim]]]] ) •> status 

where "type" is buffer type (0-5), "empty" is the value of the empty pointer, "fill" is the 
value of the fill pointer, and "dim" is the dimensioned length of the buffer. Note that the 
value returned as "type" will be negative if the buffer is busy. "Status" is set to - 1 if the 
buffer is busy and set to the fill value - the empty value if the buffer is not busy. 



I/O Buffer Pointer Control (I/O p. 6-12) 

The wtc statement can be used to set values of buffer parameters "fill", "empty", and 
"type". You cannot execute wtc to a busy buffer, nor can the buffer ever be changed from a 
word-type to a byte-type buffer (or vice-versa). Syntax: 

wtc buffer name [ >type [ »empty [ tfill] ] ] 

where "type" is buffer type (0-5), "empty" is the value for the empty pointer, and "fill" is the 
value for the fill pointer. A value of — 1 for any parameter leaves that buffer parameter un- 
changed. The following relationship must always be true: 

<= empty <= fill <= dimension 

The w t c statement now gives you the capability to re-transmit a buffer that has been 
emptied. The following example illustrates this: 



0: buf "A" ,27.1 

1 : 

2: 1 " Put data in buffer* and save value of fill pointer" 

3: wrt "A". "This could be waveform data" i rds ( " A" )->S 

4: 

5: tf r "A" .705 

6: 

7: X " Wait for tfr completion" 

8: jmp rds!"A")*-l 

9: 



10 
11 
12 
13 



Z " Rewrite fill pointer and restart transfer" 
wtc " A " . - 1 . . S ! S t o - 5 

e n d 
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Saving String Buffers to Disc (I/O p. 6 14) 

There are now three methods of saving string buffers on a disc: r c f and two types of sprt/ 
rprt. The rcf to disc is the fastest method, and all buffer pointers are preserved as they 
were for tape. To use sprt/rprt, either the buffer status must be written to the disc separ- 
ately, or the sprt/rprt operation must be directed to a binary-type data file ("NBDATA"), 
which preserves the transfer pointers automatically. The following example illustrates how to 
save the transfer pointers explicitly (non "BDATA"-type data files): 

rds ( "Buf f e r" »T tE tF )-*-!_ 5 sprt 1 *B*#E»F Save Empty and Fill pointers with 

the string buffer. 

(B$ is the string buffer "Buffer"). Now to retrieve and restore the buffer status, use wt c: 

s read i »B$ »E »F5 wtc "Buffer"»-1>E»F 

The wtc leaves Type unchanged, and sets Empty and Fill to their original values. 

The following examples illustrate saving only the active portion of a buffer (so you won't have 
to save 10 kbytes of string buffer when only 50 bytes are used). 

• Byte-type buffer: 

rds( "Buff er" »T ,E »F)-H_! sprt i »E »F tB$CE+l t F] 
sread 1 ,E »F! sread 1 »B*CE+1 tF] Swtc "Buf f e r " >- 1 ,E ,F 

• Word-type buffer: 

rdsC'Buff er" »TfEtF)-H_i sprt 1 tE >F »B$[2E+1 »2F3 
sread l»E»Fi sread 1 »B$C2E + 2F] iwtc " Buffer" »-l»EtF 



HPL Programming 4-39 



Plotter Control (I/O p. 7-4) 

Internal Graphics Control 

The 9826 and 9836 Computers both have the capability to display graphics on their internal 
CRT. The 9826 can display 300 vertical by 400 horizontal dots or pixels; the 9836 can display 
390 vertical by 512 horizontal pixels. Operation of the internal graphics is much the same as 
operation of an external graphics device, only faster. Programs designed to drive an external 
plotter will operate nearly identically with the internal graphics. Obviously, there are certain 
physical differences between the two types of device, such as pen selection, line resolution, and 
device size. 

There are two capabilities of external plotters or digitizers not offered by the internal graphics 
device: digitize (d i s) and line-type (line). These statements are not illegal when directed to 
the internal graphics screen, they merely have no effect. Thus, multi-line clusters that have a 
definite visual impact with a four-color plotter may appear confusing on the internal graphics. 
Additionally, the 9825 character set is not selected on the internal graphics screen when p c 1 r 
is executed. 

All of the operations associated with graphics on the internal CRT can also be performed on an 
external color CRT using the 98627A Color Video Interface. 

The Plotter Select Code Statement 

Selecting the graphics screen as a plotting device is done by executing 

ps c 1 B 
where 16 is the select code of the internal graphics screen. If an external plotter is selected, it 
must be an HPGL-type plotting device such as a 9872 or 7225 plotter, or a color video 
interface (98627A). 

An extended syntax for the 98627A Color Video Interface is provided to allow maximum 
flexibility for color monitors: 

ps c select code [ »TV] 

The TV parameter determines how the interface will be set up. The values allowed are: 



Value 


Monitor Type 


1 


U.S. Standard, 512x390 


2 


European Standard, 512x390 


3 


U.S. TV, 512x474 


4 


European TV, 512x512 


5 


Hi-resolution, 512x512 


6 


JVC monitors 


7 


not used 



The default setting for the TV parameter is 1. 
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The Pen Select Statement 

The pen select statement pen* has different meanings, dependent on the current plotting 
device. For the internal graphics screen, the pens syntax is: 

pen* type 

where "type" selects pen off (0), pen on (>0), eraser (-1), and exclusive-OR (-2). An 
exclusive-OR pen turns off dots that are on and turns on dots that are off. 

External plotter pen control is unchanged for HPGL plotters such as the 7225 and 9872. 

For the color video interface, the pen number is a value between - 15 and 15: 

98627A Video Interface Pen Numbers 



Color 


Store 


Erase 


OR 


XOR 


no-pen 








8 


-8 


white 


1 


-1 


9 


-9 


red 


2 


-2 


10 


-10 


yellow 


3 


-3 


11 


-11 


green 


4 


-4 


12 


-12 


cyan 


5 


-5 


13 


-13 


blue 


6 


-6 


14 


-14 


magenta 


7 


-7 


15 


-15 



A program can be written to run all graphics devices if - 9 is used for the XOR operation, - 1 is 
used for erase, is used for no pen, and 1 is used for white pen. 



Graphics Screen Control Statements 

The graphics screen may be turned on and turned off with the following two statements: 



sfof f 
Son 



(turn off graphics screen) 
(turn on graphics screen) 



These statements have no effect on the contents of the graphics memory. On the color video 
interface, these two commands are used to turn the video off or on. 

To clear the graphic screen or current "plotter is" device, use the clear graphics statement: 
^olr (clear graphics) 
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The Dump Graphics Statement 

A hard copy printout of the graphics screen can be obtained with a dot-matrix printer com- 
patible with the HP Raster Scan Standard, such as the HP 9876 and HP 2631G printers. The 
following statement implements the hard-copy graphics dump: 

sdutfflp [select code] 

The select code must include the bus address of the printer if an HP-IB printer is used, for 
example, " jfduwp 705". If the select code parameter is omitted, the system printer (prtsc) 
device is the default. 

If the color video interface is the current plotting device, the graphics dump statement will "or" 
the three color planes (red, green, blue) and dump the image to the current print device. 



The Graphics Pointer (Cursor) Statement 

Interactive graphics can be achieved with the use of either an external digitizer (or data tablet) 
or the keyboard and knob. A graphics cursor can be drawn at point x,y using the statement: 

Sptr x-coordinate > y-coordinate [ ttype] 

The x and y coordinates must be specified, and are measured in the units set by the s o 1 and 
of s statements. The "type" parameter specifies whether the cursor is to be turned OFF 
("type" = 0) or ON ("type" # 0). Default ("type" not specified) is ON. 

The pointer can be plotted on the internal CRT or on an external CRT using the color video 
interface. 



Binary Graphics 

The high-speed nature of CRT graphic makes certain speed enhancements even more desir- 
able for applications such as animation or real-time information display. These enhancements 
are EXTENSIONS to the plotting capability of the internal or an external CRT, and as such 
cannot be used with an external plotter. The first extension to be discussed is binary plot. 
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The Binary Plot Statement 

b p 1 1 string expression » bytes-per-line[ » function] 

The binary plot statement loads the binary information contained in the string expression into 
the graphics memory at the current pen position. Because there are no computations in- 
volved, this is a very high speed operation. The specified number of bytes are taken from the 
string and placed on a line, with the high-order bit of each eight-bit string character corres- 
ponding to the leftmost pixel of eight pixels. The plot statement can be used to position the pen 
to the upper left of the pixel. To conceptualize this, suppose that you want to draw the following 
character on the screen: 



Character 



Binary Decimal 



• • _• 



00000001 


(1) 


01111110 


(126) 


10100100 


(164) 


00100100 


(36) 


00100100 


(36) 


00100100 


(36) 


00100100 


(36) 


01001000 


(72) 



The graphics representation is on the left, the binary representation is in the middle, and the 
decimal equivalent is to the right. The following statements assemble the string and b p 1 o t it: 



0: 
1 : 
2: 

3: 

a-. 

5: 



dim A$[80]jP5c 1 B i So 1 r i pen i pi t 3 »3 



char<l>&char(126)8.char( 1G4 ) &pha r ( 3B ) ->A* 
fl$&char(3G)& : char(36)&char(3B)&:char(72)^A$ 
bpl t A$ .1 



Note that by specifying one byte-per-line, each byte, or character, of A$ corresponds to one 
line of graphics pixels. Specifying two bytes-per line causes two bytes of A$ to be drawn on a 
line, and 16 pixels are then defined on the line. To define 3 lines of 16 pixels per line requires 
a 6 byte string, with a correspondence as shown below: 



A$[l,l]< > < 

A$[3,3]< > < 

A$[5,5]< > < 



>A$[2,2] 
>A$[4,4] 
>A$[6,6] 



The optional "function" parameter specifies the interaction of the bpl t string with graphics 
memory. If not specified, the b p 1 1 statement performs a binary OR of the string expression 
with graphics memory. 

function =0: performs a binary OR function (default) 
function=l: performs a binary AND function 
function =2 performs a binary EOR function 
function=3: performs a STORE (overwrite) function 

The b p 1 o t statement does not affect the pen coordinates (x,y) or the pen position (up or 
down). 
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The complete syntax for the binary plot statement is: 

b p 1 1 string expression [ t string expression * string expression] * bytes-per-line [ * func- 
tion] 
The optional two additional string expressions allow for red, green, blue color planes respec- 
tively, for the color video interface. If only one string is shown as in bplt A$, then black and 
white is assumed. 

If all three strings are used for bplotting on the internal CRT, the three planes will be ORed 
together before the bplot operation. 

Note that if three string expressions such as bplt R$, G$, B$ are plotted on the internal CRT, the 
operation will slow down the bplot operation. 

The Graphics Load and Graphics Store Statements 

Two other statements facilitate high-speed graphics displays: as to re and sload. With 
these two statements it is possible to plot a series of pictures (using standard plotter com- 
mands), store each picture into a string variable, then later recall the picture series at high 
speed by sequentially loading each string variable into graphics memory. Because no com- 
putations or decisions are being made when loading the strings into the graphics display, this 
occurs very rapidly. 

The syntax for these statements is shown below: 



3 s t a re string variable 
$ 1 o a d string expression 

The sstore statement saves the graphics display into a string variable with the leftmost bit 
of the top line corresponding to the most significant bit of the first character in the string. The 
following diagram illustrates this for the 9826 CRT: 



First row 
Second row 



300th row 



r — A$[i,i]- 

, ■ . 


— A$[2,2] 

, » , 


* > > 

• • • 

* 
• 
• 

« • • 


A$[50,50] n 

, * > 








' , ■ 

A$[51,51] 
A$[14951,149 


A$[52,52] 

51] 


A$[100,100] 
A$[15000,15000] 




V. 




J 



(400 pixels) 
(400 pixels) 



(400 pixels) 



09826-90040, rev: 1/82 



4-44 HPL Programming 



As you can see, a 15,000 byte string is required to hold the entire 50 byte by 300 line display. 
If a smaller string is specified, the display will be saved up to the point where the string 
becomes full. 

The £f 1 o a d statement performs the converse operation of the § s t o r e statement, loading 
the graphics memory from the specified string expression. The transfer always begins at the 
upper-left corner of the display and with the first byte of the string expression, filling the 
screen until either the string length is reached or until the screen is full. 

The graphics strings can be loaded from disc and stored to disc, or saved in memory and 
sequenced through the graphics display. This sequencing can be used to create the illusion of 
motion or more simply to present information to the viewer more rapidly than is possible by 
using plotting commands. 

An extended syntax of the 4 1 o a d and sfstare statements is provided for the color video 
interface. The extended syntax is: 

sstore string variable RED * string variable GREEN » string variable B njE 

3 1 o a d string expression RED t string expression GREEN » string expression BLUE 

To illustrate these two commands here is an example: 

dim A* H3 ,24360] 

psc 12 

Sstore A$CU » A$C2] t A*C3] 

will cause red data to go into A$[l], green data to go into A$[2] and blue data to go into 
A$[3]. 
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Chapter 5 
Powerfail Programming 



Introduction 

Aside from the advantage of being able to sustain short power "glitches" automatically, the 
powerfail option provides some powerful features that are found only in more expensive 
systems. Among these are the capability to programmatically detect a power failure and to 
backup all data and programs before any loss occurs. This chapter details these powerfailure 
features along with the statements and functions provided by HPL 2.0 to take advantage of this 
unique protection feature. 

What Is It? 

Put very simply, the powerfail system is a big rechargeable battery that automatically comes 
"on line" for up to 60 seconds in the event of a brown-out, "glitch" or power failure. When the 
power drops, the internal clock time is stored into the powerfail unit. The powerfail unit 
generates a system interrupt which can be detected in software. This interrupt can be used to 
trigger several actions, such as to store away the data to disc. 

The sealed NICAD batteries trickle charge as long as the computer is switched on and ac power 
is up. The recharge rates for the NICAD depend on the temperature: 



Temperature Range 



0°C to 25°C 
26°C to 35°C 
36°C to 40°C 



Max. Recharge Time 



14 hrs. 

24 hrs. 

100 hrs. 



A full charge will sustain a fully loaded computer through 2 power fail/reboot cycles spaced 
close together. The number of cycles that are possible on a single full charge depends on the 
complement of interfaces and memory cards as well as the amount of internal disc access 
during the power failure. A full 60 seconds is available if a powerfail has not occurred in the last 
2 minutes. 

When the power is turned on by the power on/off switch, the powerfail backup time defaults to 
60 seconds, power failures (glitches) less than 100 milliseconds in duration are not recognized 
by the system (no interrupt generated) and the time stored in the powerfail unit is loaded into 
the internal computer clock. All times are accurate to 10 milliseconds. 

Since a clock is part of the powerfail unit, it is possible to store the time a power failure occurs as 
well as the time the power is restored to the system. 

Even though a maximum of 61 seconds is available during a power failure, there is no way to 
maintain power after 59.5 seconds even if AC power is restored. If the protection time is set to 
less than 60 seconds, subtract 0.5s from this time, and you can find the period in which AC 
power can be restored. 
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Detecting a Power Failure 



on pf ai 1 ["label" [ > protection [ > glitch]]] 
f ret 

The on powerfail statement is used to set up branching to a powerfail recovery routine or to turn 
off powerfail interrupts. 

Without the optional parameters, an p f a i 1 turns off powerfail interrupts. 

When a label is specified, a powerfail interrupt will cause a branch to the power failure routine 
to the line with that label. 

The protection parameter is the time duration that power backup will be supplied by the nicad 
battery. This can be programmed from to 60 seconds. The default is 60 seconds which is also 
the maximum backup duration. 

The glitch parameter is the time duration the system waits before issuing a powerfail interrupt. 
This can have a value of to 60 seconds. This is to prevent very short "glitches" that are not 
major from causing the system to execute the powerfail routine. The failure return statement, 
fret, should be the last statement in the interrupt routine. 

Since the glitch time and protection time start at the same time, make sure that the protection 
time is greater than the glitch time plus the service routine execution time. 

It is logical to place the o n p f a i 1 statement at the very beginning of your program. The 
powerfail routine can be elsewhere in the program. 



0! on pf ai 1 "outage" 
i: prt rtime 
2: gt. o -1 



30: "outage" : rt i me-»T 

31 : asgn " t. i me" , 1 

32: i-prt 1 , 1 , T 

33: fret 



The Power Function 

p o w e r 



Setup interrupt branch. 
Loop and print time. 



Interrupt Routine where time of 
powerfail is stored. 



The power function is useful in detecting whether you are on backup battery power or ac 
power. The values returned are: 

1 - ac power is up; powerfail hardware present 
- power failure; nicad is supplying power 
- 1 — no powerfail hardware option present, but ac power is up 
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The Power Shutdown Statement 

pshutdou n 

This statement turns the computer off, just as if the power switch was pressed off then on again. 
It turns the computer off until ac power is restored then the system reboots. If executed from the 
keyboard when ac power is present, this turns the computer off and back on again causing the 
system to go through the reboot procedure. 

This statement should be used to reserve the battery charge should several power failures occur 
in succession. 



The Power Time Function 

p t i m e ( option ) 

Depending on the value of option, this function indicates the amount of the 60 second battery 
time used up (0) or the length of the current power failure (1). 

p t i m e ( ) - returns amount of battery time used up. 
p t i fit e ( 1 ) - returns duration of current power failure. 

Using ptime (0) you can determine the maximum amount of battery time used. This is useful if 
power failures occur within 2 minutes of each other. The method used to restore the time to 60 
seconds after a powerfail is via a counter. It takes up to two minutes (2 seconds for every second 
used in previous power failures) to reset this counter to allow a full 60 seconds of battery 
backup time. 

Irregardless of the setting of the glitch time (set by on pfail) the internal timer begins the 60 
second count when the powerfail is detected, not when the interrupt occurs. 
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Chapter v) 
Color Interface Programming 

The capabilities of the 9862 7A Color Output Interface when interfaced to a color monitor are 
similar to those of an external plotter and printer. This chapter goes over some of the program- 
ming concepts when using the color interface. The first topic we cover is graphics and the 
second is alpha. 

The statements used to program an external plotter or the internal graphics on the CRT are the 
same ones used for the color interface. Some of the statements, such as bplot, have been 
enhanced to give access to the multiple color capabilities of this interface. 

Unique to HPL are the necessary statements to generate formatted text on the external moni- 
tor. This means that program listings, disc catalogs and other printouts can be viewed in color. 

One note of importance before we get into programming is the select code of the color inter- 
face. The factory setting of the interface select code is 28. Since this is outside the select code 
range used by HPL, be sure to set it to a lower value; in the program examples, we use select 
code 12. 



Color Video Operations 

The Graphics Instructions 

All plotter statements that work with the internal CRT graphics are supported on the color 
interface. The following lists the statements (described in Chapter 4) which have been ex- 
tended. 

bplt - now has two optional string parameters. One string means black and white. Three strings 
mean red, green, and blue, respectively, Example: bplt A$ > B$ » C$ » 2 

gclr - acts on the current plotting device set by the psc (plotter select code) statement. 

gdump - ORs the three color planes and dumps to the printer set by the prtsc (printer select 
code) statement. 

gload/gstore - allows one or three strings in the same manner as bplt. 
sstore A$ [ 1 ] » A$ C 2 3 * A$ [ 3 ] causes red data to go into A$[l], green data to go into 
A$[2], and blue data to go into A$[3]. 

gptr - puts a cursor on the video monitor if it is the plotting device set by the psc statement. 
gon/goff - turns the video on or off. 
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pen# - selects the color of the "soft" plotter pen. pen# also allows you to erase, exclusive OR, 
or inclusive OR the colors together. 

psc - the plotter select code statement has been enhanced to allow a wide range of color 
monitors to be attached to the color video interface. 

Since the operation of all of these graphics operations are explained in Chapter 4, let's go over 
using a few of them for programming. 

Using the Statements in Programs 

Since the computer assumes that you are using an HPGL plotter at 705 (9872 type plotter on 
HPIB) when it is turned on, the first step is to change these defaults. The psc (plotter select 
code) statement changes the select code from the default. So, the first statement in your 
program should be a psc statement. 

For the Barco monitor we used, the psc statement was: psc 12 

Then, to "clear" the monitor off, put a gclr statement next in your program. 

Now, let's just draw a few lines: one in red, one in cyan and one in blue. First scale the plotting 
area so that the end points of the lines are within the CRT limits: 

scl 0»100»0»100 

Now to plot the individual lines: 

4: pen# 2;% "select red pen" 

5: pit 10, 10,1; % "move to X=10, Y=10" 

6: pit 50, 50, 2; 7. "draw to X=50, Y=50" 

7: pen# 5;% "select cyan pen" 

8: pit 0,50;% "draw to X=0, Y=5p" 

9: pen# 4;% "select green pen" 

10s pit 10,10;% "draw to X=10, Y=10" 

To save the entire image away, you can use the gstore instruction to put the image into three 
string variables: 

Ssto re R$ »G* »B$ 

R$ contains the dot pattern for red, G$ for green and B$ for blue. Once the colors are in the 
string variables, it can again be loaded back onto the screen by the gload instruction: 

Sload R$»G$»B$ 
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Final Program: 



0: dim R* t 24960 3 ,G*C 24960 D, B*C 24960 3 

1: psc 12 

2: gclr 

3: scl 0,100,0,100 

4s pen* 2;% "select red pen" 

5: pit 10,10,13% "move to X = 10, Y=10" 

6: pit 50,50,2;% "draw to X=50, Y=50" 

7: pen* 5;% "select cyan pen" 

B: pit' 0,50;% "draw to X=0, Y=50" 

9: pentt 4;% "select green pen" 

10: pit 10,10;% "draw to X=10, Y=10" 

11: gstore R*,B*,B*;% "put graphics image into string variables" 

12: stp 

13: gclr 

14: stp 

15: gload R$,G$,B*;% "reload string image onto crt" 

16: end 

*24181 

Character Animation 

The next example shows how to use bplt with the color card and the knob to generate anima- 
tion. The program is documented to show what each step in the program is doing. 



6: 
1: 

3: 
4: 
5i 

6: 
7: 
8: 
9: 

10: 
11: 
12: 
13: 
14: 
15: 
16: 
17: 
18: 
19: 
20: 
21: 
22: 
23: 
24: 
25: 
26: 
27: 
28: 
29: 
30: 
31: 
32: 
33: 
34: 
35: 
36: 
37: 
38: 
39: 
40: 
41: 
42: 
43: 



•.for 1 = 1 to 21 
to 3 



dim R*[63:,G*C63],E*CS3],fl*C4] 

fxd 

psc 12;5: "Required to do Text-'Graphi cs on col 

gclr;?: " C 1 ear graph its i mage on mon i t or " 

"Red": for- 1 = 1 to 21;/J "21 rows in image" 

for J=l to 3;''. "3 bytes - 24 columns in image 

read R;''. "load an octal data byte" 

st r <R>-*fl*; '-: "put data byte into string" 

Rtichar Cval Cfi*, 8> >-»R$; 'A "convert octal to dec 

next J 

next I 

"Green" 

for J=l 

read G 

str<G>-»fl* 

G*8<char (val <ft$, S'j >-*Gf 

next J; next I 

"Blue": for 1=1 to 21 

for J=l to 3 

read B 

str<B)*FI* 

B*&char ( val (Fit, 8> )*B$ 

next J; next I 

scl 0,100,0,106 

pen# -1 

on knob "move" 

T*X 

pit X,50 

bplt R*,G*,B*,3,2 

bplt R*,G*,B*,3,2 

g t o 27 

"move " : knob+X+X 

kret 

stp 

"Red Data": 

data 0,0,0, 0, 377, 0, 7, 0, 340, 14,9, 30 

data 10,0,10,20,0,4,21,201,204,41,201, 264 

data 40, 0,4, 40, 0,4, 40, 0,4, 41,0, 204 

dat a 40 , 20 1 , 4 , 20 , 1 02 , 4 , 2S , 74 , 1 , 1 u , , 1 

dat a 4,0,20,2,0,49, 1,301,300,6,76,0,0,0,0 

"Green Data" : 

data 0,0,0,0,0,0,0,0,0,0,0,0 

, 201,200, 1 ,201 , 200 

,0,0,0,0,0 



'ide 



i nt ert'ac e* 



i m a 1 " 



data 0,0,0,0,0,0, 1 
data 0,0,0,0,0,0,6 
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This program makes a three-color happy face. Using the knob allows you to move the happy 
face back and forth across the middle of the screen. 



Alpha Text Programming 



In this section, the text capabilities of the color interface are described. The examples show how 
to print text in different colors and how to print text in any location on the monitor. 

The distinction between alpha and graphics is the way characters are placed on the monitor. 
Using the lbl (label) statement, the character is plotted, using short vectors, on the CRT. This is 
somewhat slow. Using prt (print) or list# (or several other statements), characters are generated 
from dots, just as you would see on a dot-matrix printer. Labeled characters, even though they 
are slower, can change size using csiz (character size) and can be plotted in different directions, 
too. Text which is printed cannot be enlarged or rotated, only printed as on a printer. 

Even though we are describing alpha operations, it is important that you place the psc state- 
ment and prtsc in your programs even if you are not doing graphics. 

All of the alpha operations described use the wti (write interface) statement to access registers 
on the color interface. Before you can access these registers, first execute: 

wti Of select code 

where select code is the select code of your color interface. This "opens" the interface to give 
access to the individual registers. Once the wti > select code operation is performed, other 
wti or rdi operations access that interface, so only one wti 0, select code operations is needed to 
access several registers. 

Setting the Alpha Print Position 

The internal CRT uses the tabxy statement to set the alpha print position. On the color inter- 
face, the syntax for the same operation is: 

wti it alpha print position 
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The alpha print position parameter is a 16-bit word of the format. 



REGISTER 1 

Most Significant Bit 



Alpha Print Position 

Least Significant Bit 



Bit 15 



Bit 6 



y Position 



Bit 5 



Bit 



x Position 



This register is a read/write interface. So, if you need to know what the current print position is, 
you can check it by using: 

r d i 1 * V 
and decoding the value of V to find the current x,y coordinates: 



U mod 64 * X 
int (V/64) * Y 



(x coordinate) 
(y coordinate) 



The 0,0 location on the CRT is the upper left corner of the CRT. The maximum characters per 
line is 64 (0 to 63) as you might expect. The number of lines (y positions) depends on the 
number of scan lines (this depends on the monitor you have). To calculate the maximum 
number of y positions use this: 

y positions = int (height scan lines/12) 
For the Barco monitor we used, the number of scan lines is 390. So, the number of lines is: 

int (390/12) or 32 
This means that lines through 31 can be used. 

The following example is a simple program that asks for an x,y coordinate and places an 
asterisk at the x,y position on the monitor. 



10: 
11: 
12: 
13: 
14: 
15: 
*22: 



Color- 
sc 12 
rtsc 
xd a 
rt. ch 
1 oop" 

f X<0 

loopl 
f Y<0 
f X<0 
X + Y*2 
ut i 
wt i 1 
prt " 
gto " 
end 



Video Alpha Print. Position": 
; X "Re q u i r e d t o u s e T e x t .-- G r ap h i c s o n c o 1 o r 
12;" 1 : "Printer is the color video interface' 



vide 



C 1 e ar s c r e e n u i t h f o r m feed" 
' print position (0 to 63>: 
" ; qt o "loop" 

print position C0 to 33; 
" ; gto " 1 oopl " 
or Y>33;dsp " " ; gt 
to store in 



ar CI 2 ) 

: e n t " E n t e r 

or X>63jdsp 
" : ent "Enter 

or Y>33;dsp 

or X>63 or Y<0 or Y> 
"6-*P;/i "Compute value 
,12;': "Select color i 
, P ; y. "Set alpha pr i nt 
* " 
1 oop" 



f f or regis 
posi t i on on 



" 1 oo 
-eg. 
if ac 
: o 1 o r 



:ess 
i .-'f 
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Writing to the Holding Register and CRT 

To place a character into the alpha holding register, the syntax is: 
w t i 4 > character 

The character parameter is an 8-bit character that corresponds to an ASCII character. If you 
were to execute: 

wti 4 * 65 

the letter "A" would be stored in the alpha holding resgister. To transfer this to the CRT, the 
following syntax is used: 

wti 7 » dummy parameter 

Any 16-bit value can be used for the dummy parameter since the value isn't used. The wti 
operation to register 7 is often referred to as the trigger operation, transferring data from register 
4 to the display. 

The Interface Set-up Instruction 

The configuration of the Color Video Interface can be set up by writing to register 5 of the color 
interface. The syntax for the setup operation is: 

wti 5i 8-bit register value 

The diagram for this register is: 



REGISTER 5 

Most Significant Bit 










Interface Setup 

Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Scroll Bit 


Don't Care 


Reset 

1 = Reset 
= Reset 


Graphics 
On/Off 

1 = gon 
= goff 


Reset 
Monitor Type 


Monitor Type 

Not Used 

1 U.S. Standard (default) 

2 European Standard 

3 U.S. TV 

4 European TV 

5 Hires 

6 JVC 

7 Not Used 


1 = Scroll 
= Scroll 
(default) 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 
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To reset the interface, bit 5 is set. All other bits are ignored if bit 5 is set. To set this bit use: 

wti 5 » ual < "00100000" ,2) 

The scroll bit, bit 7 allows you to provide scrolling where new lines of text stack up from the 
bottom and move the top line off the CRT. Also, you can turn off scrolling. In this mode, the 
text sent to the CRT "wraps". This means that after the CRT is filled, new lines of text write 
over from the top down. 

Bit 4 does the same operation as the gon and goff instructions performed. We recommend 
using gon-goff for compatibility reasons. 

Bit 3 is only useful if bits thru 2 are being changed. The psc statement performs the same 
operation and for compatibility should be used instead. 

Select Text Color and Inverse Video 

Writing to register 6 on the color video interface sets the color that text appears on the CRT. In 
addition, the text can be displayed in inverse video if desired. 

wti Gt 8-bit register value 

The diagram of register 6 is: 



REGISTER 6 

Most Significant Bit 








Text Color & Inverse Video 

Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Not Used 


Red 

1 = Red 
= Red 


Green 


Blue 

1 = Blue 
= Blue 


Not Used 


Inverse 
Video 

1 = Inverse 
Video 

= Normal 
Video 


1 = Green 
= Green 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4' 


Value = 2 


Value = 1 



The default value is 0: normal video, with red, green and blue on (white text). 
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The following example shows the different combinations of color and inverse video. 



10 

11 

12 
13 
14 

15 
16 
17 
*l: 



"Col 
psc 
di Hi 
prts 
fxd 
prt 
wt i 
for 
for 
len( 
w t i 
i.o t b 
wt i 
: prt. 
ne 
n e 
i,.i t i 
end 
S492 



or Video Text": 

12;": "Set select, code- for color video inter-face" 

Z*C4],T*[4];" "-*Z* 

c 12;': "Printer is the color video interface" 



c h ar C 1 2 > ; ;■: "Clear scree n w i t- h f o r m f e e d " 

0,12;:-: "Select, color i -'f for register access" 

X=0 to 1 

I=X to 2---7-1 by 16;* "Loop to set bits 4, 5 ii 6 of colot 

str<I>+T*)*T 
6,0;:-: "Select White text in reg. 6" 
12,Z$[T:8,T$4:" u ;% "Print Register value" 
€,,!;': "Set color/inverse video on color if" 

"HaBbCcDdEeFfGgHhli J.iKkLlMmNnOoPpQqRrSsTtUuVvWuXxYvZz" 
t I 
t X 

0,12;wti 6,0;:-: "Restore reg. 6 to unite on black" 



> i d e o i / f ' 



Summary of Alpha Instructions 



w t i Oi select code 

w t i 1 » position 

r d i 1» variable 

w t i l\ t character 

w t i 5t value 

w t i B > value 

w t i It dummy value 



Gives access to the color video instructions for the color inter- 
face at the specified select code. 

Sets the x and y position for printing text (similar to tabxy). 

Reads the current text position into the variable. 

Places the ASCII character into the holding register. The trig- 
ger operation (wti 7,0) transfers this character to the CRT. 

Sets parameters on the color interface such as TV type, and 
scroll or wrap. 

Selects the text color and inverse video or normal video dis- 
play. 

Used in conjunction with register 4, this operation triggers the 
interface and transfers the ASCII character in the holding regis- 
ter to the display. 



09826-90040, rev: 1/82 



A-l 



Appendix A 

Disc Programming 
Technical Appendix 



Supported Device/Format Combinations 

HPL 2.0 will support 4 distinct disc drives and 2 different mass storage directory formats. The 
supported drives are: 

9826 or 9836 internal minifloppies (5Vi inch double-sided discs) 

82900 Series minifloppy (5V4 inch double-sided discs) 

9885 floppy (8 inch single-sided discs) 

9895 floppy (8 inch double or single-sided discs) 

The supported directory formats are: 

HP Corporate Logical Interchange Format (LIF) 
9825 format (also 9835/9845 etc.) 

The 9825 format is supported on the 9885 and 9895 drives as "F" and "H" device format 
specifiers, providing backward compatibility with the 9825/9835/9845 series computers. 
Program, data, and key files are fully compatible with 9825 files. Data files are compatible 
with 9835/9845 data files, provided the logical record length is 256 bytes per record (the 
default). Moreover, 9825 bootstraps are not required on discs, enabling compatibility with 
9835/9845 initialized discs. 

LIF is supported on the internal and 8290x series drives, enabling data interchange with 9826 
BASIC discs and others via ASCII (INTERCHANGE) files. LIF is also supported on the 9885 
and 9895 discs, both for the unique features it offers, and for compatibility with future main- 
frames. 

Device Format Table 



Device 


Disc Type 


Disc Format 


Select Code 


HP-IB 


Default 


Unit Number 


Format 






Range 


Address 


Select Code 


Range 


Specifier 








Range 


Value 




I 


Internal 


LIF 1 


_ 


_ 


. 





M 


8290x 


LIF 1 


1-15 


0-7 


700 


0-3 


F 


9885 


9825 Compatible 


l-15(not7) 


- 


8 


0-3 


G 


9885 


LIF 1 


l-15(not7) 


- 


8 


0-3 


H 


9895 


9825 Compatible 


1-15 


0-7 


707 


0-3 


J 


9895 


LIF 1 


1-15 


0-7 


707 


0-3 



1 LIF: Hewlett-Packard Logical Interchange Format: File type ASCII is compatible with 9826 BASIC language ASCII files and with HP 2642A 
Terminal files. 
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9826 HPL's Implementation of LIF 

HP Corporate Logical Interchange Format (LIF) is a standard defining the logical structure of 
mass storage media, notably discs. The standard concerns itself with: 

1. Layout of file structure on the disc 

2. Location and configuration of directories 

3. Interchange data types 

4. Location and configuration of the volume label 

Most of these concerns are transparent to the user, since they are automatically handled by 
the HPL operating system, however, there are several topics the user should have a know- 
ledge of with respect to how LIF affects him. These topics are discussed below. 

LIF Disc Structure 

The structure of LIF discs is simple compared to 9825-format discs. Sector contains the LIF 
volume label (system record); sector 1 contains all Os as defined by the standard; and sector 2 
contains the first record of the directory. The user file space begins following the last record of 
the directory, and spans the remainder of the disc. There is no backup directory. 

With 9826 HPL, the default directory size is the number of records required to fill up the first 
track. For 5V4 inch minifloppies (16 sectors per track), this yields 14 directory records; for 8 
inch floppies (30 sectors per track) this yields 28 directory records. The initialize statement has 
been extended to allow the user to specify how many directory records he wants. Refer to the 
section on the initialize statement for details. 

Rules for Legal File Names 

The LIF standard has rather stringent restrictions for file names. File names are from 1 to 10 
characters in length; the characters are to be of the set of uppercase English alphabetics and 
the digits through 9; furthermore, the first character is to be alphabetic. 

9826 HPL's LIF implementation has relaxed the file name restrictions, allowing 9825 type file 
names to be specified. If you wish to interchange a 9826 LIF disc with that of another compu- 
ter, however, you MUST adhere to the restrictions described in the paragraph above! 

The test for legal file names is applied only when 9826 HPL creates a file name entry, not 
when 9826 HPL merely accesses a file name. Any file name can be referenced, as long as it 
does not contain a colon, a null character, or imbedded blanks. Blanks preceding, imbedded 
in, or trailing the file name are ignored. 

If the user wishes for his disc to conform fully with the LIF standard, then it is his responsibility 
to name his files accordingly. 
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LIF Directory Entries Support Larger File Sizes 

Due to limitations with the 9825-format directory, most files on these discs are restricted to be 
65536 bytes or smaller in size. This applies to PROGRM, KEYS, SBDATA, NBDATA, and 
BINARY files; this does not apply to TDATA files! Since the maximum user memory size for 
the 9825 was 62K bytes, this size restriction was never a problem. However, with 9826 HPL 
supporting a MUCH larger user memory size, it is easily possible to run into the 65K byte limit 
on 9825-compatible discs. 

Because of larger fields in the LIF directory, LIF discs do NOT have this file size restriction; 
and are capable of handling any size file required by 9826 HPL. 

LIF Discs May Require More Frequent Repacking 

Under certain conditions, attempting to create a file on a LIF disc may result in error D8, 
(insufficient storage space on disc), even though the catalog listing shows that enough space is 
available. This same error can occur with 9825-format discs; stemming from the fact that the 
available space may not be contiguous. If a repack is performed (with the repk statement), 
the available space will all become contiguous, and files can be created to consume the re- 
maining available space. 

With LIF discs, though, there is an additional complicating factor associated with the creation 
of files: the order of the actual files is required to be exactly the same as the order of the 
directory entries of those files. Thus, even if a large enough block of contiguous space exists 
out in the user area, an open slot must also exist in the proper place in the LIF directory, else 
error D8 will be issued. A simple disc repack will cure this problem, allowing the creation of 
the additional files. The bottom line is: LIF discs may require repacking more often than do 
9825-format discs. 



LIF ASCII Files 

"ASCII" (or interchange) files are defined by the LIF standard, and are fully supported with 
9826 HPL. "ASCII" files created by all mainframes that implement the LIF standard should 
be completely interchangeable. LIF "ASCII" files are the primary data interchange mechan- 
ism between 9826 HPL and 9826 BASIC. ASCII files are not supported on 9825-format 
discs. 

Creating ASCII Files 

ASCII files are created with the open statement. Refer to the section for the open statement 
for a discussion of syntax. 

Example: 

open "ascii-f ile" ,10 »" ASCII" 
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Assigning ASCII Files 

ASCII files are assigned with either the files or the asin statements, exactly in the same 
manner as typed data files are assigned, with the exception that if a return variable is present 
with the assign statement, it will return a value of 10 instead of a value of 0. 

Examples: 

files ascii_file 

asSn "ascii-f ile:M70Z >2" *Z >-l »R 

Accessing ASCII Files 

ASCII files are accessed via the s p r t and sread statements. ASCII files are, by definition, 
strictly serial in nature. Any attempt, with one exception, to access them with r p r t or 
r r e a d will result in an error. The one exception is "rread N > 1 " ; it is allowed for the 
purpose of resetting the file pointer back to the beginning of the file. All syntaxes and variable 
list items allowed on typed data files with sprt and sread and also allowed on ASCII files. This 
includes simple numerics, numeric arrays, simple strings, string arrays, and others. As for 
typed data files, arrays are printed and read on an individual element basis. 

Autoverification of s p r t to ASCII files is governed by von/voff. 

Each data element in an ASCII file is, by definition, a string of ASCI I characters. Though 
referred to as an "ASCII character", each character is allowed to have any 8-bit binary value 
(0 to 255 if interpreted as 8 bit unsigned; - 128 to 127 if interpreted as 7-bit signed). 
Numerics printed to an ASCII file undergo a BCD to ASCII conversion similar to the str 
function conversion. The precision and format are determined by the current fxd/flt setting. 
Unlike the str function, however, the "E" produced as a result of a fit setting will be upper- 
case as opposed to lowercase; this is required by the LIF standard. Numerics read from an 
ASCII file undergo an ASCII to BCD conversion similar to the val function conversion. Unlike 
the u a 1 function, however, either a lowercase or an uppercase "E" will be accepted as being 
part of a floating point number. 

Each ASCII file data element consists of a two-byte header, designating the number of char- 
acters in the element, followed by the actual characters. The character count must be between 
and 32767, and the header itself does not contribute to the character count. If the count is 
odd, a null byte is inserted after the last character, so that the next data element header will 
always begin on a word boundary. A character count of - 1 designates a logical end of file. 
The standard defines all other negative character counts to be illegal; 9826 HPL treats them 
as logical end-of-file marks, and no error is issued. 

ASCII data elements pay no regard to physical record boundaries (except the physical end of 
file), and thus they incur no additional overhead when they cross physical record boundaries. 
However, this implies that the only way to traverse an ASCII file is to start at its beginning, 
and read or print serially. In other words it is impossible to look at an arbitrary record and 
determine where data elements begin or end. Random reads and prints are disallowed. 



Technical Appendix A-5 



With ASCII file serial prints, the "end" and "ens" parameters work in a way as identical as 
possible to the way they do with typed data files, considering the fact that ASCII files have no 
logical end-of-record mark. Here are the rules: 

1. If "end" or neither parameter is specified, a logical end of file mark is printed after the 
last data item, if physically there is room in the file. 

2. If "ens" is specified, nothing is written after the last data item. Whatever was there 
originally will remain. (As is with typed data files, this powerful yet dangerous feature 
requires a thorough knowledge of file structure and access methods. ) 

Examples: 

sprti* "hi there!" 

dim A* [50 3 »B*C5 tlOO] »AC10] is read 1 »A »AC*] >A* »B* 

r read 1 » 1 

Using the Type Function with ASCII Files 

Use of the type function is allowed with ASCII files. The type function will always return a 
value of 2 (meaning "full string") or 3 (meaning "end-of-file mark"). 

Example: 

if type(l)#35sread 1 >A$ Sprt At 5 Jmp 

Using On End with ASCII Files 

Use of the o n e n d statement is allowed with ASCII files. The on-end branch will be taken if 
either a physical or logical end of file is reached. 

Example: 

on end 1 » " e n d of file reached" 
sread 1 > At 5 p r t A 1 5 J m p 
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Binary Data File Support 

Binary data files, corresponding to the 9825's tape file types 2 (numeric) and 3 (string), are 
fully supported under 9826 HPL's tape statement emulation. In addition, the HPL disc- 
oriented data file statements have been extended to allow them to access these same binary 
data files. This enables the user to utilize binary data files without being forced to use tape 
statements. 

9826 HPL's binary data files are in no way compatible with 9835/9845 binary data files. 
However, they have a similar set of advantages and disadvantages, when compared with 
typed data files. 

Advantages 

• Binary data files can be accessed efficiently on discs that are initialized to their suggested 
minimum interleave factor; efficient TDATA and ASCII file access requires a larger inter- 
leave factor. Thus, up to a 2x speed performance can be achieved if the disc is initialized 
to the minimum suggested interleave factor AND binary data files are used. 
Strings are recorded in their entirety, rather than by their current length. Thus, with string 
buffers, the type, empty pointer, and fill pointer are always automatically recorded along 
with the string. 



• 



Disadvantages 

• The variables in the variable list must be a contiguous block in memory, as required 
when recording data to the 9825 tape cartridge. 

• The entire file is recorded/loaded as one block operation; individual portions of the file 
cannot be accessed separately. 

• If the file is string or mixed data (SBDATA), the data list for the read operation must be 
identical in structure with the data list used to print the file. There is no way to deter- 
mine the data list structure of an unknown file. 

• Strings are recorded in their entirety. If a string is dimensioned 10,000 bytes long, all 
10,000 bytes (plus overhead) will be recorded, even if the current length is only 10. 

Creating Binary Data Files 

Binary data files are originally created as a NULL files, corresponding to the 9825 tape file 
type 0. When data is written into the NULL file, its type is changed to either NBDATA or 
SBDATA, depending upon whether the data is strictly numeric or not. NULL files are created 
with either the m r K statement or the o p e n statement. The open statement is the more 
flexible of the two, allowing arbitrary file names (and optional msus), whereas the m rK state- 
ment creates file names corresponding to pseudo track and file numbers. 

Examples: 

open "b_f i le:M" 1 10 t"NULL" 
rew it rk ?w rK 5 »2000 
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Assigning Binary Data Files (for Disc-oriented Statement Access) 
Binary data files are assigned with either the files or the as an statements, exactly in the same 
manner as typed-data files are assigned, with the exception that if a return variable is present 
with the assign statement, it will return a value other than 0. The possible return values for 
binary data files are: 

4 SBDATA (String or Mixed Binary Data) 
7 NBDATA (Numeric Binary Data) 
12 NULL (Null - no data written yet) 

Examples: 

files b_f ile 

as an "b_f ilesF" »5 

Accessing Binary Data Files 

Binary data files are accessed with the sp rt and s read statements exclusively. The other 
disc data statements, r-prt, rread, type, and on end are not allowed due to the nature 
of binary data files. 

An sprt or sread access to a binary data file is identical to a rcf/ldf, with the following excep- 
tions: 

1. the "file number" parameter refers to an assigned file number instead of a tape marked 
file number. 

2 autoverification of sprt is controlled by von/voff instead of ave/avd. 

3 hardware errors will result in disc hardware error messages instead of tape hardware 
error messages. 



Assigned File Pointers 
on 8290x Series Minifloppies 

In HPL, when a data file is assigned, a set of internal pointers is set up, pointing to the 
assigned file's area on disc. Prints and reads to the data file then use the internal data file 
pointers, not the disc directory. If HPL detects that the disc drive's door has been opened, it 
clears all pointers associated with that drive, since they are now meaningless. Then, if the user 
attempts to use those file pointers without reassigning them, he gets error F6 (Unassigned 
data file pointers). 

The hardware of the current 8290x Series Minifloppies, however, is incapable of detecting if a 
door is opened between disc accesses. This makes it impossible for HPL to reliably know 
when it is necessary to clear the file pointers when discs are swapped. A hazard exists if a user 
assigns data file pointers to an 8290x Series drive, swaps discs, and then prints using those 
same file pointers without reassigning them. Instead of error F6 being issued, the print will 
take place, writing on the new disc where the assigned file existed on the old disc. Unpredict- 
able results can occur, resulting in a loss of programs and/or data! 
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9885 Disc Access Requires 
a DMA Card Present 

The 9885 driver on the 9825 used the 9825' s built-in DMA channel to access the 9885 disc. 
The 9885 driver on the 9826 also needs a DMA channel; however, since the DMA card is an 
option, it may not be present. If the DMA card is not present, and an attempt is made to 
access the 9885, error fl will be issued. 



HP-IB Programming Considerations 

(9895 and 8290x Series Discs) 

Most of the HPIB Programming Considerations mentioned in the "9825 Disc Programming 
Manual", part # 09825-90220, are valid for the 9826. However, due to hardware and low- 
level driver differences, items 1, 8, & 9 are not valid for 9826 HPL. 



9826 HPL Disc Programming Error Messages 

When 9826 HPL is unable to access a disc controller, it issues error message fO instead of 
flashing "DISK IS DOWN" or "UNABLE TO ACCESS DISC CONTROLLER". This means 
that the error is now trappable from your user program. There are 9 other new error messages 
associated with 9826 HPL Mass Storage, as shown below: 

fO Unable to access disc controller 

fl 9885 driver requires a DMA card present 

f2 Invalid msus syntax; illegal device/format specifier 

f3 Directory entry field overflow 

f4 Illegal structure on LIF disc; cannot be repacked 

f5 Attempted disc copy to significantly larger disc 

f6 Attempted disc copy of 9825-compatible disc to LIF disc or vice-versa 

f7 System record not valid for LIF disc 

f8 System record not valid for 9825-compatible disc 

f9 Statement not implemented 
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The table on the following page lists the ASCII control codes of the 9826 command and 
cursor-control keys. This table is useful when developing programs that use the p k b d state- 
ment, and also when controlling the 9826 from a remote ASCII keyboard (such as a ter- 
minal). 

The Keycode Conversion Table on pages B-3, B-4 is useful for designing a 9826-to-9825 
hardware keycode conversion table. This is necessary only when a 9825 program was de- 
signed to work with hardware keycodes (rdb(0)->K). To implement the conversion, two 
methods are possible. One is to use a jump table (requiring no variables, but expensive in 
memory used). This method is used in the utility "9825 key" for keycode conversion. The 
other method involves a 256 byte string, with the position in the string corresponding to the 
9826 8-bit keycode, and the character at that position corresponding to the 9825 keycode. 



B-2 Code Charts 



9826A ASCII Control Codes 



CTRL 
of 


ASCII 
Value 


ASCII 
Character 


9826A Key 
Pressed ' 


Displayed 
Character 3 


@ 





NUL 


reserved 


N 
U 


A 


1 


SOH 


PAUSE 


S 
H 


B 


2 


STX 


REWIND 


S 
X 


C 


3 


ETX 


HOME LEFT \<- 


E x 


D 


4 


EOT 


HOME RIGHT -»l 


E 
T 


E 


5 


ENQ 


TO TOP t 


E 
Q 


F 


6 


ACK 


TO BOTTOM | 


A 
K 


G 


7 


BEL 


RESULT 


■U 


H 


8 


BS 


INSERT LINE 


B 

S 


I 


9 


HT 


DELETE LINE 


H 
T 


J 


10 


LF 


EXECUTE 


L 
F 


K 


11 


VT 


RECALL 


V 

T 


L 


12 


FF 


RUN 


F 
F 


M 


13 


CR 


ENTER 


C 

R 


N 


14 


SO 


CLR TO END 


S 

a 





15 


SI 


CLR SCREEN 


s 
i 


P 


16 


DLE 


DOWN ARROW 


D 
L 


Q 


17 


DC1 


UP ARROW 


D 

1 


R 


18 


DC2 


CLEAR LINE 


0^ 


S 


19 


DC3 


PRINT ALL 


D 
3 


T 


20 


DC4 


LEFT ARROW 


D 


U 


21 


NAK 


RIGHT ARROW 


N 

K 


V 


22 


SYN 


INSERT CHAR 


S 
Y 


W 


23 


ETB 


DELETE CHAR 


E 
B 


X 


24 


CAN 


STEP 


C 
N 


Y 


25 


EM 


CONTINUE 


E 
M 


Z 


26 


SUB 


DUMP GRAPHICS 


S 
8 


[ 


27 
28 


ESC 
FS 


DISPLAY FUNCTIONS 
EDIT 


E 
C 

F 
S 


] 


29 


GS 


CAPS LOCK 


G 
S 


" 


30 


RS 


ALPHA 


R 

S 


- 


31 


US 


GRAPHICS 


u 
s 


1 This is the 

2 This is the 
»J This is the 


9826A pkbd 
shift")" key 
displayed ch 


keypress and the 
on the Numeric K< 
aracter if "DISPL/ 5 


key pressed from a remote ASCII k 

ypad. 

lYED FUNCTIONS IS ON". 


eyboard. 



09826-90040, rev: 1/82 



Keycode Conversion Tables 



Code Charts B-3 



9 3 2 6 


Hard ui 


ar e 




Ke 


,'codes 


* 




DEC 


OCT 


h e ;; 


CM 


a a e 





3 8 


h 


001 


8 1 


01 




602 


8 8 2 


2 




033 


e 3 


3 




004 


884 


8 4 




805 


385 


8 5 




666 


86 


6 




00? 


037 


07 




3 3 


1 


8 3 




y 9 


e 1 1 


3 9 




1 B 


012 . 


ofi 




1 i 


1 3 


0E 




012 


1 4 


OC 




013 


8 1 5 


0B 




14 


8 16 


0E 




B 1 5 


01? 


8F 




1 6 


02 6 


1 




e i ? 


8 2 I 


1 1 




B 1 3 


022 


12 




19 


i:, p ;■:; 


13 




9 2 


2 4 


14 




2 1 


8 25 


15 




22 


8 2 6 


16 




02 3 


8 2 * ' 


17 




24 


3 


1 3 


% 


25 


6 3 1 


1 9 


* 


26 


032 


lfl 


¥ 


027 


03 3 


IB 





B23 


8 34 


1C 


r 


02 9 


8 35 


ID 




3 


036 


IE 


7 


8 3 1 


8 3 ? 


IF 


T 


33 2 


43 


2 8 


i 


033 


8 4 1 


21 




034 


8 4 2 


22 


D 


03 5 


84 3 


2 3 


D i 


036 


84 4 


24 


■I' 


3 7 


345 


25 


-tl 


3 3 


6 46 


2 6 


^ 


3 9 


047 


2 7 


\ 


040 


05 


28 


£, 


8 4 1 


85 1 


2 9 


H 


042 


052 


2(1 


'4 


04 3 


53 


2E 


-\ 


344 


854 


? c. 


h 


845 


85 5 


2D 


"i: 


46 


85 6 


2E 


Li * 


04 7 


857 


2F 


F F 


48 


8 6 8 


3 3 


F_ 


49 


8 6 1 


3 1 


fi:_ 


50 


62 


3 2 


Hr 


051 


6 3 


3 3 


;i 


052 


364 


3 4 


B, 


05 3 


6 5 


3 5 


V 


85 4 


6 fa 


3 6 


°, 


055 


b? 


O 7 


< 


356 


078 


3 8 


- M 


057 


8 7 1 


3 9 


\ 


3 5 8 


072 


3fl 


■fc, 


59 


3 7 3 


3E 


L F 


060 


374 


3C 


8 


8 6 1 


3 75 


3D 




062 


076 


3E 


, 


6 3 


877 


3F 




06 4 


1 8 8 


4 8 


\ 1 


8 6 5 


1 1 


41 


2 


366 


102 


42 


3 


06? 


1 8 3 


4 3 


- 


068 


1 8 4 


44 


4 


06 9 


1 8 5 


4 5 


5 


ere 


106 


4 6 


f. 


07 1 


16? 


47 


* 


072 


1 18 


4 3 


7 


073 


! 1 1 


4 9 


g 


07 4 


112 


4H 


9 


075 


1 13 


4B 





3 3 2 5 Hardwa r e 

K?vcodes 

DEC ' OCT HEX 



9826 Hardware 
K 5 y c o d e s * 
DEC ' OCT he; 



ASCII 
C H H R EEC 



9825 Hardware 
K e y c o d e s 

DEC " C T H E > 



380 
8 3 2 
8 3 2 
332 
832 
032 
6 32 
032 
632 
632 



6 32 
32 

6 32 
032 
032 

32 

8 3 2 
8 3 2 
632 
82 9 
125 
128 
129 

1 3 
1 3 3 
1 3 4 
135 
131 
13 2 
6 1 fa 
8 1 7 
1 3 6 



38 

8 
8 8 8 
3 3 8 
8 8 8 
00 3 
88 

6 
6 3 

666 
080 
36 

00 


8 6 

88 8 
8 8 
8 8 8 
06 
066 
8 6 
300 
8 80 

06 

125 
865 
866 
8 6 7 
37 
7 1 
072 
6 8 
b 9 
8 lb 
1 7 
073 



1 3? 


874 


20 


8 2 8 


02 1 


02 1 


8 8 8 


6 3 


6 3 9 


9 


1 1 


8 1 1 


022 


82 2 


023 


023 


614 


03 


6 20 


020 


6 12 


3 1 2 


628 


028 


3 3 


608 


3 3 1 


680 


024 


024 


018 


013 


6 7 


8 8 i ■" 


19 


319 


2 52 


06 3 


8 8 1 


00 1 


613 


313 


825 


025 


8 1 


10 


648 


078 


4 6 


8 88 


344 


089 


343 


04 3 


3 4 9 


879 


3 50 


380 


05 1 


8 8 1 


4 5 


34 5 


852 


82 


8 5 3 


8 8 3 


854 


384 


84 2 


3 4 2 


85 5 


685 


56 


686 


057 


087 


04 7 


04? 



8 80 

6 36 

8 8 8 

600 
000 

608 

8 

00 3 

88 

8 
60 
386 

638 

06 

3 8 8 
8 8 8 
8 8 
80 

00 

8 8 8 
366 

3 00 

3 6 

38 

1 75 
101 
162 
1 8 3 
1 6 6 
187 
1 18 
184 

1 8 5 

02 
32 1 
1 1 1 
1 12 
024 
025 

1 3 

01 1 

013 



366 
324 
014 
8 34 

3 86 

3 
3 
022 
86? 

823 

66 

8 1 

3 15 
831 
612 

1 16 
1 3B 
131 
65 3 
1 1 7 
120 
12 I 
055 
122 
1 2 3 
124 
352 
1 2 5 
1 26 
12? 
65 7 



88 

8 


8 

8 8 
3 

00 

8 



3 

3 8 



83 
8 
8 
8 
8 

3 
00 
81 8 
88 
00 
8 8 
8 8 
7D 

4 1 
42 
4 3 
4 6 
47 
4 8 
44 
45 
1 
1 1 
49 
4H 
14 
15 
8 

9 
6B 
16 

1 7 



1 4 
SC 

1C 



6 

1 8 



1 3 


8 1 

0D 

1 9 

3 a 

4E 



4F 
5 3 
5 1 

2D 



54 
2H 



56 
5? 
2F 



87 



79 
68 8 
6 3 1 
082 
383 
84 
085 
036 
6 37 
6 8 8 
639 

8 90 
9 1 
092 
093 

09 4 
09 5 
096 
9 7 
9 8 

9 9 

1 

1 1 

102 
163 

1 4 
1 5 
106 
1 7 

1 8 8 
1 8 9 

1 18 
1 1 1 

1 12 

1 1 3 
1 14 
1 1 5 
1 16 
1 17 
1 1 8 
1 1 9 
1 2 8 

12 1 
1 2 2 

1 24 
1 25 
1 2 6 

1 28 
129 
1 3 8 

13 1 
132 
1 3 3 
134 
1 3 5 
136 
1 3 7 
1 38 
139 
143 
1 4 1 
1 42 
143 
144 
145 
14b 
147 
148 
1 4 9 
I 5 
1 51 



1 14 
1 15 
1 1 6 

1 17 
1 20 
1 21 
1 22 
1 2 3 
124 
125 
126 
1 2? 
1 3 8 
1 3 1 

1 3 3 
1 3 4 

1 3 5 
136 
1 3 7 
148 
14 1 
142 
143 
1 4 4 
1 45 
146 
1 47 
1 5 8 
151 
152 
1 5 3 
154 
155 
156 
15? 
1 6 8 
161 
1 62 
1 6 3 
1 6 4 
1 65 
166 
16? 
1 7 8 
17 1 
172 
173 
174 
1 7 5 
1 7 6 

1 77 
236 
28 1 

2 82 



285 
206 
287 
21 3 
21 1 
212 

214 

2 16 
2 17 



4C 
4E 

4 E 
4F 

5 
5 1 



5D 
5E 
5F 
6 8 

6 1 



S3 
6 9 
6H 
6E 
6 C 

6 3 
6E 
6F 

7 
7 1 



?B 
?C 

?n 

7E 
7F 
3 8 
8 1 

O O 

3 3 
84 
85 



8fl 
3B 

8 C 
3D 
3E 
8F 

9 3 
9 1 
9 2 
9 3 
9 4 



13 1 


096 


148 


6 8 


040 


46 


50 


2 8 


8 4 1 


6 4 1 


85 1 


2 9 


894 


094 


1 3 6 


5E 


49 


649 


6 1 


3 1 


6 5 


50 


62 


3 2 


651 


05 1 


663 


3 3 


6 52 


052 


6 64 


3 4 


653 


35 3 


86 5 


3 5 


6 54 


354 


86 6 


3 6 


055 


055 


06? 


3 7 


65 6 


656 


8 7 


-.; O 


05? 


8 57 


07 1 


3 9 


048 


48 


060 


3 8 


84 5 


4 5 


655 


2D 


3 6 1 


06 1 


075 


3D 


39 1 


1 84 


270 


ES 


09 3 


1 8 5 


271 


B9 


65 9 


05 9 


73 


31: 


39 


176 


2 60 


B8 


044 


344 


854 


2C 


846 


34 6 


656 


2E 


647 


04 7 


057 


2 F 


6 3 2 


832 


040 


2 6 


1 1 1 


ill 


1 57 


6 F 


1 1 2 


1 12 


1 6 


7 8 


16? 


1 6 7 


153 


6B 


168 


1 8 8 


154 


6C 


1 1 3 


1 13 


161 


7 1 


1 19 


1 19 


1 67 


-y 7 


1 31 


161 


145 


6 5 


1 14 


1 1 4 


162 


7 2 


1 16 


116 


1 6 4 


74 


12 1 


12 1 


171 


7 9 


1 1 ? 


1 17 


165 


-? cr 


165 


105 


15 1 


6 9 


6 9 7 


097 


14 1 


61 


1 1 5 


1 15 


163 


7 3 


1 6 3 


1 6 


144 


64 


102 


132 


1 4 6 


6 6 


1 CI 3 


1 6 3 


1 47 


67 


134 


1 34 


150 


6 3 


106 


186 


152 


6H 


109 


189 


155 


6D 


1 22 


1 2 2 


172 


7fi 


1 26 


1 28 


170 


7 8 


693 


399 


143 


6 3 


1 18 


1 18 


166 


7 6 


6 93 


398 


142 


62 


1 10 


1 18 


156 


6E 


G 3 2 


300 


see 


8 8 


3 2 


386 


3 6 6 


3 8 


832 


036 


3 6 6 





83 2 


6 3 8 


6 





83 2 


66 








032 





03 





032 


6 30 


6 00 


8 


63 2 


3 


00 





6 32 


00 3 


008 





32 


6 3 


660 





632 


36 6 


00 8 


6 


6 32 


360 


8 





83 2 


800 


08 


8 8 


632 


006 


388 


6 


3 2 


000 


3 6 6 


8 8 


83 2 


336 


00 


06 


8 3 2 


00 


00 


8 8 


3 2 





636 


8 8 


032 


! 00 


8 8 6 


8 8 


632 


8 


008 


6 


6 3 2 


6 08 


8 08 


6 


032 


888 








632 


668 








32 


30 


668 


8 6 


6 32 


860 


86 6 





632 


806 


000 






B-4 Code Charts 



98 2 6 


Hardw 


are 


HS 


: 1 1 


982 5 


Hard i.i 


ar e 


9826 


Hardw 


are 


HSC 


I I 


9 82 5 


Hards 


a r e 


Ke 


ycodes 


* 






Ke 


y c odes 




Ke 


vcodes 


* 






Ke 


/codes 




DEC 


OCT 


HEX 


C H H R 


DEC 


DEC 


OCT 


HEX 


EEC 


OCT 


H E !■: 


C H H R 


DEC 


EEC 


OCT 


HEX 


152 


230 


9 8 


^ 


S29 


00 


008 





238 


346 


E6 


K 


075 


235 


-j =j -z. 


EB 


153 


2 3 1 


9 9 


-j 


125 


1 25 


1 75 


7B 


23 1 


347 


E7 


L 


076 


236 


354 


EC 


1S4 


232 


9fl 


i 


133 


075 


1 13 


4B 


232 


350 


E8 


Q 


as 1 


241 


3 6 1 


Fl 


155 


233 


9B 


* 


1 3 9 


076 


1 14 


4C 


233 


3 5 1 


E9 


11 


08 7 


247 


36 7 


F7 


1 5 6 


234 


9C 


l* 


140 


1 9 3 


3 8 1 


C 1 


23 4 


352 


Efl 


E 


869 


229 


345 


E5 


1 57 


;'.' 3 t' 


911 




1 4 3 


1 9 6 


3 4 


C4 


2 35 


35 3 


EB 


R 


S8 2 


242 


36 2 


F2 


1 5 8 


236 


9E 


- 


1 44 


1 9 7 


305 


C5 


2 36 


354 


EC 


T 


084 


244 


36 4 


F4 


15? 


237 


9F 


7 


1 45 


198 


3 06 


C6 


2 37 


35 5 


EB 


Y 


089 


249 


371 


F9 


160 


240 


AS 


2 


141 


194 


30 2 


C2 


2 38 


3 5 6 


EE 


U 


885 


245 


36 5 


F5 


161 


24 1 


fll 


3 


142 


195 


3 3 


C 3 


2 3 9 


357 


EF 


I 


8 7 3 


2 3 3 


3 5 1 


E9 


162 


242 


R2 


\ 


05 


144 


2 20 


9 


240 


36 


F8 


fl 


065 


225 


3 4 1 


El 


1 6 3 


24 3 


R3 


ft 


096 


145 


221 


9 1 


241 


3 6 1 


Fl 


g 


83 


243 


3 6 3 


F3 


164 


244 


H4 


i 


1 46 


1 99 


3 7 


C7 


242 


36 2 


F2 


B 


68 


228 


344 


E4 


165 


245 


H5 





1 47 


200 


310 


CS 


2 43 


. r '. 


F3 


F 


70 


230 


346 


E6 


166 


24 6 


fl6 


£ 


03 


148 


224 


9 4 


244 


3 6 4 


F4 


G 


07 1 


23 1 


347 


E 7 


167 


247 


R7 


E t 


04 


149 


225 


9 5 


245 


36 5 


F5 


H 


072 


232 


358 


E8 


168 


25 


H8 


B.. 


6 8 


136 


210 


88 


246 


3 6 6 


F6 


J 


74 


234 


352 


ER 


16 9 


25 1 


H9 


h T 


009 


137 


21 1 


89 


247 


3 6 7 


F7 


H 


8 77 


2 3 7 


355 


EH 


17 


252 


flfl 


\ 


1 1 


1 39 


2 1 3 


SB 


248 


370 


F8 


z 


890 


25 8 


3 72 


Ffl 


17 1 


25 3 


HE 


-\ 


022 


150 


22 6 


96 


249 


3 7 1 


F9 


?, 


838 


2 4 8 


3 78 


F8 


172 


254 


RC 


h 


023 


151 


227 


97 


250 


372 


Ffl 


c 


067 


2 2 7 


3 4 3 


E3 


173 


255 


RE 


1 


251 


000 


00 





25 1 


3 7 3 


FB 


v 


086 


246 


3 6 6 


F6 


174 


256 


RE 


D 4 


020 


148 


224 


9 4 


O ^i ? 


3 74 


FC 


B 


066 


22 6 


342 


E2 


175 


257 


RF 


F F 


012 


140 


214 


3C 


253 


375 


FB 


N 


078 


23 8 


356 


EE 


176 


2 6 


B8 


E 


02 7 


156 


234 


9C 


254 


3 7 6 


FE 




8 32 


80 8 





8 8 


177 


26 1 


Bl 


u 


254 


30 


000 





255 


377 


FF 




3 2 


8 8 8 


8 


8 


173 


262 


B2 


"E 


02 6 


300 


00 





















179 


2 63 


B3 


Ei 


253 


152 


23 3 


98 


















1 8 


264 


B4 


s i 


013 


146 


2 2 2 


9 2 


















18 1 


265 


B5 


^ 


252 


135 


287 


87 


















1 82 


2 66 


B6 


i 


■? =; ■"> 


147 


223 


9 3 


















1 8 3 


2 67 


B7 


s 


00 1 


00 1 


8 1 


01 


















184 


2 70 


B8 




3 2 


129 


201 


81 


















1 8 5 


27 1 


B9 


\ 


013 


141 


21 5 


en 


















186 


2 72 


BR 


^ 


025 


153 


2 3 1 


99 


















1 8 7 


2 73 


BB 


L r 


010 


138 


2 1 2 


8fl 


















188 


274 


EC 





34 8 


206 


316 


CE 


















1 8 9 


2 7 5 


BB 




046 


216 


3 30 


18 


















1 9 


2 76 


BE 


, 


044 


21 7 


3 3 1 


H9 


















191 


277 


BF 


+ 


34 3 


1 7 1 


2 53 


HB 


















1 9 2 


3 a 


C>3 


1 


049 


207 


3 17 


CF 


















1 9 3 


301 


CI 


2 


050 


2 8 8 


3 20 


B8 


















1 9 4 


3 02 


C2 


3 


051 


209 


32 1 


Bl 


















195 


3 S3 


C3 


- 


045 


1 7 3 


255 


FID 


















196 


3 04 


C4 


4 


052 


2 1 


3 2 2 


D2 


















1 9 7 


3 5 


C5 


5 


53 


21 1 


323 


D3 


















198 


30 6 


C6 


6 


54 


2 12 


324 


B4 


















1 9 9 


3 u 7 


C7 


* 


042 


1 70 


252 


flfl 


















28© 


3 1 


C 8 


7 


55 


213 


325 


D5 


















2 1 


31 1 


C 9 


8 


56 


214 


3 26 


D6 


















20 2 


312 


Cfl 


9 


057 


215 


327 


D7 


















203 


313 


CE 




047 


175 


257 


RF 


















204 


314 


cc 




96 


300 


800 


8 8 


















205 


315 


CE 


I 


1 24 


251 


3 7 3 


FB 


















266 


316 


CE 


r 


9 2 


2 22 


3 3 6 


DE 


















287 


31 7 


CF 




1 26 


000 


000 


08 


















20 3 


320 


D0 


! 


3 3 


i 7 7 


2 6 1 


Bl 


















2 9 


32 1 


D 1 





664 


183 


267 


E7 


















2 1 


3 22 


B2 


# 


3 5 


179 


26 3 


E3 


















21 1 


3 2 3 


D3 


* 


36 


180 


264 


E4 


















212 


324 


D4 




37 


181 


265 


B5 


















213 


325 


B5 




094 


094 


1 3 6 


5E 


















214 


3 26 


n 6 


t. 


03 8 


182 


26 6 


B6 


















21 5 


3 2 7 


B7 


* 


04 2 


842 


052 


2fl 


















216 


3 30 


B8 


( 


04 


163 


250 


fi8 


















217 


3 3 1 


B9 


i 


04 1 


169 


25 1 


R9 


















21 3 


332 


BR 




395 


000 


000 


80 


















219 


3 3 3 


BB 


+ 


843 


1^1 


2 53 


fiB 


















220 


3 34 


DC 


fl 


12 3 


123 


1 7 3 


7B 


















221 


3 35 


DD 


-s 


125 


1 25 


1 75 


7D 


















2 '"' "'■' 


3 36 


BE 




353 


1 7 8 


2 6 2 


B2 


















223 


337 


DF 


" 


03 4 


1 9 1 


277 


EF 


















224 


3 4 


E0 


; 


060 


1 7 2 


254 


RC 


















225 


3 4 1 


El 




062 


1 74 


2 56 


RE 


















2 26 
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Appendix L, 
Differences in HPL 1.0 and HPL 2.0 

This appendix describes briefly the differences in HPL 1.0 and HPL 2.0. The major difference is 
in the enhancements to the language for the 9836A, the powerfail option and color video 
interface. Additionally, a few statements were added and the known bugs were corrected. 

You can boot HPL 2.0 on either the 9826 or the 9836 Computer. Programs created with HPL 
1.0 will run on HPL 2.0. 

Mass Storage Operations 

The 9836A Computer has two 5V4 inch disc drives built-in. The right-hand drive is the default 
drive; be sure to insert the system disc in the right-hand drive to boot the system. To specify 
each drive within HPL mass storage operations, use these specifiers: 

:I,0 Right-hand drive 
:I,1 Left-hand drive 

For example: 

copy ":I f0" t "to" » " : I * 1 " 

copies the entire media from the right-hand drive to the left-hand drive. 

Graphics Changes 

Gload in HPL 2.0 is about 3 times faster than with HPL 1.0 (28 frames/sec on 9826). Gload 
from odd-byte boundaries, however, does not change. 

Bplt in HPL 2.0 is about twice as fast as with HPL 1.0. 
The full National Character sets are supported in labeling. 

HP 98627A Color Interface Support 

All plotter statements that work with the internal graphics are supported on the color card: 

bplt — now has two optional, additional strings as parameters. One string means black and 
white. Three strings stand for red, green, blue. Three strings on the 9826 or 9836 internal 
screen will OR the three values together before the bplt. For example: 

bplt R*tG$»B*t2 

R$, G$, and B$ give data for red, green and blue color planes, respectively. If G$ and B$ are 
not given, the bplt will be black and white. 

09826-90040, rev: 1/82 



C-2 Differences in HPL 1.0 and HPL 2.0 



gclr — acts on the current plotter is (psc) device. 

gdump — ORs the three planes and dumps to the specified device. 

gload and gstore — allow one or three strings, as with bplt. 
For example: 

dim A*[3»249G0] 

ps c i 2 (if the color card is on select code 12) 

sfstore A$C13 »A[23 »A*C3] 
stores red data in A$[l], green data in A$[2] and blue data in A$[3], 
gprt — puts a cursor on the color video monitor. 
gon and goff — turns the video on and off. 
pen# — the pen number can be a value from - 15 thru 15: 

98627A Video Interface Pen Numbers 



Color 


Store 


Erase 


OR 


XOR 


no-pen 








8 


-8 


white 


1 


-1 


9 


-9 


red 


2 


-2 


10 


-10 


yellow 


3 


-3 


11 


-11 


green 


4 


-4 


12 


-12 


cyan 


5 


-5 


13 


-13 


blue 


6 


-6 


14 


-14 


magenta 


7 


-7 


15 


-15 



A program can run all graphics devices if - 9 is used for the XOR operation, - 1 is used for the 
erase, is used for no-pen and 1 is used for the white pen. 

psc — The syntax is: 

psc select code [ »TV] 

The TV parameter configures the interface for: 

1 U.S. STD, 512 x 390 pixels (default) 

2 EURO STD, 512 x 390 pixels 

3 U.S. TV, 512 x 474 pixels 

4 EURO TV, 512 x 512 pixels 

5 HI RES, 512 x 512 pixels 

6 JVC monitors 
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Color Alpha 

Precede these write interface operations with w t i » select code to control alpha on the 
98627A Interface: 

Select Alpha Print Position 

w t i 1 > expression 

r d i 1 * variable 

Register 1 is read/write, so you can determine where the next character will go, and/or change 
the position. Upper-left screen is 0,0. Bits 15 thru 6 are Y position. Bits 5 thru are the X 
position. 

All supported screens have 64 characters across, X value can be from 63 thru 0. The number of 
lines (Y positions) depends on the number of scan lines. The number of lines allowed is: 

int (height scan lines/12) 

For example, 512 high has 42 lines. 

Write Character to Holding Register 

w t i 4t expression 

Register 4, bits 7 thru is the character (write only); use in conjunction with w t i 7*0. 

Set Up Color Interface 

w t i 5 > expression 

Register 5 is write-only: 

Bit Contents 



7 1 = no scroll; = scroll (default) 

6 don't care 

5 1 = reset; = do ops specified by other bits 

4 1 = GON;0 = GOFF 

3 1 = update interface type; = don't update 

2 1 (0,7 = notused 3 = U.S. TV 6 = JVC 

1 interface type 1 = U.S. STD 4 = EURO TV 

qJ l2 = EUROSTD 5 = HIRES 



Transfer Holding Register to Screen 

w t i It expression 

Transfers the character in the holding register to the color monitor. This is used in conjunction 
with wt i 4. 
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You can do any standard output to the color video interface. The interface recognizes these 
control characters: backspace, linefeed, vertical tab, and horizontal tab. For example: 

cat 12 

list #12 

wrt 12. "HI" 

prtsc 1 2 ; 1 i s t K (color card is set at sleet code 12) 



Note 

The 98627A usually uses two select codes. This can be avoided by 
setting it to select code 6. 

Powerfail Support 

The powerfail protection defaults to 60 seconds at power-up. The glitch time (time delay before 
a powerfail is recognized) is set to 60 ms. Power back time is set to Vz second. 

The stime statement (no parameters) transfers battery clock time into the internal clock. The 
time March 1, 1900, is the same for all languages. Executing stime sets the time to March 1, 
1900. 

The on pfail statement is modified with HPL 2.0: 

on pfail [line label [ > protection [ » glitch ]]] 

Executing on pfail with no parameters turns off powerfail interrupts. Line label is the pointer to 
the powerfail routine. Protection is the time to preserve the machine (maximum and default is 
60 seconds). Glitch is the time to wait before issuing a powerfail interrupt (default is 100 ms). 

Use the fret statement to return execution from the powerfail routine. 

The power function returns the powerfail state: 

1 = powerfail installed and operating. 
= power failed. 
- 1 = power up but no powerfail hardware. 

The pshutdown statement switches the computer off and on again (to re-boot the system). 

The ptime function returns the amount of battery time used: 

dsp ptime (0) — displays the amount of battery time used. 

dsp ptiwe (1) — displays the length of current powerfail. 
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Display Control 

The 9836A display has an 80-column line width. Display enhancements such as inverse video 
and underlining can be controlled using the crt statement: 

crt value 

The value specifies which enhancement(s) to set: 

bit - inverse video 
bit 1 - blinking 
bit 2 - underline 
bit 3 - half bright 

The machine function returns details of the host computer configuration: 

bit (0»machine) = 80-column alpha; 1 = 50-column alpha 

b i t ( 1 t m a c h i n e ) = 400 x 300 graphics; 1 = 512 x 390 graphics 

b i t ( 2 t m a c h i n e ) = no highlights on CRT; 1 = highlights 

bit ( 3 » machine) = keyboard present; 1 = no keyboard 

Data Transfers 

The tfr statement now works to select code (dsp line) and to/from select code 16 (crt 
print/scroller). 

Error Trapping 

ems 3 ( "XX" 5 returns the string "error XX message". 

e m s 3 (em trow) returns the string ' 'error XX message" . 

emsJ ( e r n » r o m > e r 1 ) returns the string "error XX in LLLL message". 

String Search 

The find statement lists all lines containing a specified string expression to the printer is device: 

find string expression [, linel [ » line2]] 
The search occurs from linel thru line2. 

On-event Changes 

New parameters are added to the on key and on knob statements: 

on K e v [ line label [ » flag [ > rate [ > delay ]]]] 

The rate parameter is the time between repeats when a key is held down. Range is thru 2.55 
seconds. Default is 0.08 sec. 
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The delay parameter is the time before starting to auto-repeat keys. The range is 0. 1 thru 2.56 
seconds. The default is 0.7 sec. 

o n k n o b [ line label [ t rate ]] 

The rate parameter specifies the number of seconds between knob interrupts. The range is from 
0.01 thru 2.56 seconds. The default is 0.01 sec. 

For both on key and on knob, the defaults for rate and delay are in effect unless a program is 
running which sets new rate and/or delay values. When a program is paused, the defaults are in 
effect until after execution resumes and a key or knob is used. 

Major HPL 1.0 Bugs Fixed in HPL 2.0 

• Executing tabxy from edit screen destroyed the scroller. 

• Scaling on psc 16 was inaccurate for small deltas. 

• Interrupt and fast read/write HP-IB transfers could leave the HP-IB in a non-holdoff mode. 

• ( CLR SCR ) key on edit screen could leave the insert cursor in the middle of screen. 

• Continuing a null program could hang the machine. 

• Loading a program larger than the available memory could hang the machine. 

• File names could not use characters greater than ASCII 127. 

• bred garbaged a word. 

• rss, wsc, and wsm garbaged r5. 

• pen; pit X, Y didn't put a dot at X, Y on the internal CRT. 

• int (100000000000) returned 99999999999. 

• gptr was clipped by lim and hard-limited screen edges. 

• gptr turned off existing graphics cursor on an error. 

• Executing line-feed in the middle of the last scroller line (CRT) could collapse and wrap the 
scoller memory. 

• gptr was not turned off by reset and was forgotten when a reset was performed. 

Human Interface Changes 

Capslock of A 6 A E N. (Bit 13 of keycodes is now Capslock bit and is used by asc function 
for keycodes generated by rdb(0) and key.) (Note that the "cap" function still only works on 
"a-z" and "A-Z".) 



The cursor is non-advancing for diacriticals ' * " " for a e i o u. 

Katakana mode shift in/out on Katakana keyboard (Bit 12 of keycodes is now Katakana bit.) 
(250 is pkbd shift to Katakana. 249 is shift to ASCII. ) 

Shift-backspace is 127, rubout. 

There is a 10 deep recall stack now. Shift-recall/recall is like BASIC. (248 is pkbd value for 
shift-recall. ) 
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Delete-line key puts line on the recall stack. 

Error messages are enunciated in English. 

Extra edit line on 9836. 

Form feed (dec. 12) is recognized by the printer/scroller (select code 16). 

Keyboard line is not cleared by a stopping program or by an ent or enp statement, (i.e. edit A$ 
is now available by pK b d A$ 5 en t A$). 

80 character support on 9836 including scrolling of CRT highlights. 

Errors automatically turn on alpha. (This will not happen if error is trapped by the on err 
statement. ) 
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Appendix L) 

Alphabetical List of 
HPL Extensions/Revisions 



a c 1 r [number of pages] 

Clears screen, allocates specified number of scrolling pages 

ad um p select code 

Dumps alpha screen to printer 

aof f 

Alpha off 

a on 

Alpha on 

b p 1 1 string > # bytes per line [ * function] 

Plots binary data in string to the graphics screen. 
Function: = OR, 1 = AND, 2 = EOR, 3 - STORE 

c ret 

Returns to the program from an on-cycle routine. 

cycle 

Returns the number of clock cycles since last executed. 
One cycle = 10 milliseconds. 

data numeric or string constant [ » numeric or string constant]... 
Provides constants for read statement variables. 

d ret 

Returns to the program from an on-delay routine. 

3c 1 r 

Clears the graphics screen. 

3 d u m p select code 

Dumps the graphics screen to a raster-scan standard printer. 

Soft 

Turns the graphics display off. 

Son 

Turns the graphics display on. 

sfptr xcoord »ycoord[ »type] 

Draws a graphics cursor at the specified location, (type: - off) 
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3 1 o a d string expression 

Loads the graphics screen from the specified string. 

3 s t o r e string expression 

Store graphics screen to the specified string. 

k 1 o f f 

Turns special function key labels off. 

k 1 o n 

Turns special function key labels on. 

k n o b 

Returns the accumulated knob count. CCR rotation is negative valued, CR rotation is 
positive valued. 

k re t 

Returns to the program from an on-knob routine. 

k s t a t 

Returns knob status: 5 - Control, 4 = Shift 

m r e t 

Returns to the program from an on-match routine. 

ms i [ : device format [ controller select code [ »unit number]]] 
Sets the current system disc drive and format. 

Drive formats: I=internal disc, M=8290x minifloppy, F=9885(9825), G = 9885(LIF) 
H=9895(9825), J=9895(LIF) 

on cycle time [ t label] 

Sets up clock periodic interrupt service routine, o n cycle with no label specified can- 
cels clock-cycle interrupt service. 

on delay time [ * label] 

Sets up clock delay interrupt service routine, on delay with no label specified cancels 
clock-delay interrupt service. 

on knob [label] 

Sets up Knob interrupt service routine, o n knob with no label cancels Knob interrupt 
service. 

on match time[ » label] 

Sets up clock match interrupt service routine, on match with no label cancels clock- 
match interrupt service. 

p b e e p [frequency [ > duration]] 

Programmable beep with frequency (0-5167 Hz) and duration (0-2.56 seconds). 

pi 

Returns value of pi. 

pkbd [string] 

Executes ASCII string (as if it were pushing keys). 
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prtsc select code [ » width] 

Sets system printer select code (and width) 

r c b [file number] 

Records the binary program in memory to the specified tape file. 

r d s ( buffer name[ » type [ * empty [ > fill [ * dim ]]]] )— ^status 
Extended buffer status function. 

read variable name [ * variable name] 

Reads data statement constants into variables. 

r k b d select code [ >type] 

Enables remote keyboard: type 1 = ASCII, type = 9826A 

rstr [label] 

Resets data pointer either to line 0, or to "label" if specified. 

r t i ft! e 

Returns internal clock value in elapsed seconds. 

s a u e b file name 

Saves the binary program in memory to the specified file. 

s f k key number [ > definition string [ » label string]] 
Defines SFK (0 to 32) and optional soft label. 

s <=! r variable 

Returns the square root of the specified variable. 

s t i w e seconds 

Sets the internal clock to the specified number of seconds. 

s v s b o o t [system name] 

Boots language system specified from disc or ROM. 

tab xv xcol >yrow 

Moves print position to column x (0...49), row y (0...17). 

wtc buffer name [ *type[ »empty[ tfill]]] 

Write buffer pointers to specified buffer name. 

w t c HP-IB select code, value 

Resets HP-IB interface. If "value" is <31, sets new bus address = "value". If 
"value" =31, no further action. If "value" >31, "value" configures Parallel Poll res- 
ponse. 
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Subject Index 1-1 



Subject Index 



a 

Aclr - alpha clear 4-3. 1 

Adump - alpha dump 4-4 

Alpha 4-3.1,4-3.2 

Alpha clear 4-3.1 

Alpha mode 2-4 

Alpha off 4-3.2 

Alpha on 4-3.2 

Alpha text, color 6-7, 6-8 

Animation 4-43, 6-1, 6-3 

Aon - alpha on 4-3.2 

Arithmetic 2-16 

Array output 4-13 

ASCII codes A-3, B-2, B-3 

ASCII filetype 4-20, 4-21 

ASCII LIF files A-3 

Asgn - assign 4-16 

Autostart 2-1 

b 

Back panel 1-4 

Backup 1-15, 4-22 

Battery backup 4-34, 5-1 

Battery clock 4-34, 5-1 

BCD interface 4-28 

Beep, programmable 4-3 

Binary data files A-6 

BINARY filetype 4-24 

Binary graphics 4-41, 6-3 

Binary plot 4-41, 6-3 

Binary programs 4-8, 4-24 

Blinking 4-3.1 

Boot system 4-13 

Bplot - binary plot 4-42, 6-3, C-l 

Buffer empty 4-37 

Buffer full 4-37 

Buffer pointer 4-37 

Buffer status 4-37 

Buffer storage 4-38 

Buffer types 4-38 



c 

Cables, power 1-4 

Cartridge tape 4-6 

Cat (see tlist also) 4-20 

Catalog (see tlist also) 4-20 

Cleaning disc drive 1-11 

Clock, internal 4-34, 5-1, 5-3 

Clock, powerfail 5-1, 5-3 

Color video interface 4-39, Chap. 6 

Colors 4-40, 6-2, 6-7 

Compatibility, data file 1-14 

Computer installation 1-3 

Computer maintenance 1-11 

Contents iii 

Control codes B-2 

Copy 1-16, 4-22 

Copying discs 1-15 

Cords, power 1-4 

Cret - cycle return 4-35 

Cross reference 4-5 

Crt alpha 4-3.1,4-3.2 

Crt display 2-3, 4-3 

Crt graphics 4-39 

Crt organization 2-3 

Crt printer 4-5 

Crt read 4-4 

Cursor, graphics 4-41 

d 

Data file compatibility 1-14 

Data statement 4-2 

Data transfer 3-3 

Default sfk 2-14 

Define sfk 4-12 

Deleting files 4-21 

Diagnostics 1-17 

Differences, HPL 1.0/2.0 C-l 

Digitize 4-39 

Directory size 4-17 

Disc drive cleaning 1-11 

Disc format 4-14, A-l 

Disc handling 1-12 

Disc initialization 4-17 

Disc insertion 1-13 
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Disc read statement 4-24 

Disc type function 4-19 

Disc write statement 4-24 

Discs 1-12, A-l 

Display (see crt) 

Display organization 2-3 

DMA - direct memory access 4-28, A-8 

Dred - disc read 4-24 

Dret - delay return 4-36 

Drive 4-17 

Dtype - disc type 4-19 

Dump alpha 4-4 

Dump graphics 4-41, 6-1 

Dwrt - disc write 4-24 



e 

Edit mode 2-7 

Empty buffer 4-37 

Error messages A-8 

Errors Back Cover 

Extended control sfk 2-13 

f 

FCC Radio Interference Statement 1-7 

File backup 1-15, 4-22 

File copy 4-23 

File open statement 4-21 

File pointers A-7 

File protection 1-13 

Filetypes 4-20 

Find 2-14, 4-5 

Flags 4-5 

Flexible discs 1-12 

Floppy discs 1-12 

Fret - fail return 5-2 

Full buffer 4-37 

Fuses 1-4 



g 

Gclr - graphics clear 4-40, 6-1 

Gdump - graphics dump 4-41, 6-1 

Gload - graphics load 4-43,6-1 

Goff - graphics off 4-40, 6-1 

Gon - graphics on 4-40, 6-1 

GPIO interface 4-28 



Graphics 4-39, 6-1 

Graphics clear 4-40, 6-1 

Graphics mode 2-4, 4-40, 6-1 

Graphics off 4-40 

Graphics on 4-40 

Graphics, binary 4-41, 6-3 

Gstore - graphics store 4-43, 6-1 

h 

Half-bright 4-3.1 

HP Sales Offices Back 

HP-IB disc interface A-8 

HP-IB interface 1-10, 4-29 

HPGL plotters 4-39, 4-40 

HPLl.Ovs. HPL2.0 C-l 

HPL extensions D-l 

HPL syntax D-l 



1 

I/O 4-26 

Ibackup - file backup 1-15 

Immediate continue sfk 2-12 

Immediate execute sfk 2-12 

Init - initialize 4-17 

Initialize disc 4-17 

Input/Output 4-26 

Interface installation 1-10 

Interface, HP-IB 1-10, 4-29, A-8 

Interfaces 4-26 

Interleave 4-17 

Internal clock 4-34, 5-1 

Interrupts 4-35, 5-2 

Inverse video 4-3. 1 

k 

Key buffer 4-10 

Key labels 2-10, 2-14, 4-4 

Keyboard 2-5 

Keycodes B-3 

Keys 2-5 

Keys, character entry 2-5 

Keys,*editing 2-6 

Keys, numeric 2-6 

Keys, program control 2-15 

Keys, special function 2-10, 4-4, 4-12 
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Keys, system control 2-9 

Killall statement 4-21 

Knob 4-9 

Knob status - kstat 4-10 

1 

Labels, international characters C-l 

Labels, key 2-10, 4-4, 4-12 

LIF 1-15, A-l 

LIF ASCII files A-5 

Line fuses 1-4 

Line type - line 4-39 

Line voltage 1-3 

Load graphics 1-15, 4-43 

Logical Interchange Format - LIF A-l 



m 

Machine 2-1, 4-3 

Mainframe diagnostics 1-28 

Maintenance 1-11 

Mass storage is - msi 4-16 

Mass storage unit specifier 4-14 

Math functions 4-5 

Memory installation 1-8 

Mode, alpha 2-4, 4-3.2 

Mode, graphics 2-4, 4-40, 6-1 

Monitors 4-39, 6-6, C-2 

Mret - match return 4-36 

Mrk (see init) 

Msi - mass storage is 4-16 

Msus 4-14 

Multi-statement sfk 2-13 



n 



NBDATA filetype 4-21 

NULL filetype 4-20, 4-21 



o 

On cycle 4-35 

On delay 4-36 

On end A-5 

On knob 4-9 



On match 4-36 

On pfail - on powerfail 5-2 

Oni - on interrupt 4-35 

Open statement 4-21 

Operations, arithmetic 2-16 

Output/Input 4-26 



P 

P-variables 4-5 

Pbeep - programmable beep 4-3 

Pen number 4-40 

Pen# 4-40, 6-2 

Pi 4-5 

Pkbd - press keyboard 4-11 

Plotters 4-39, 6-1 

Power cords 1-4 

Power function 5-2 

Powerfail 5-1 

Press keyboard - pkbd 4-11 

Printing date " 

Printing history " 

Program transfer 3-2 

PROGRM filetype 4-20 

Psc - plotter select code 4-39, 6-1 

Pshutdown - power shutdown 5-3 

Ptime - power time 5-3 



r 

RAM - random access memory 1-1 

RAM installation 1-8 

Rcb - record binary 4-8 

Read clock 4-34, 5-3 

Read crt 4-4 

Read statement - red 4-4, 4-8 

Read, data, restore 4-2 

Record binary 4-8 

Remote keyboard 4-11 

Restore statement 4-2 

Rkbd - remote keyboard 4-11 

ROM - read only memory 1-1 

RS-232 interface 4-31 
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s 

Save binary 4-24 

SBDATA filetype 4-21 

Screen (see crt) 

Screen organization 2-3 

Scrolling buffer 4-3. 1 

Search (find) 4-5 

Secure 4-20 

Serial interface 4-31 

Set clock 4-34, 5-1 

Set time 4-34, 5-1 

Sfk 2-11 

Sfk - define special function key 4-12 

Sixteen-bit parallel interface 4-28 

Special function key definition 4-12 

Special function keys 2-10 

Sqr function 4-5 

Square root function 4-5 

Status, buffer 4-37 

Status, knob 4-10 

Store graphics 4-43 

String function - str$ 4-8 

String variables 4-8 

Strings ($) 4-8 

Supported discs 4-14, A-l 

Sysboot 4-13 

System boot 4-13 

System printer 4-5 

System Tests 1-17 

Systems programming 4-9 



V 



Value function - val 4-8 



w 



Write protect 1-13 



X 



Xref - cross reference 4-5 



t 

Table of Contents iii 

Tabxy 4-4 

Tape cartridge 4-6 

TDATA filetype 4-21 

Text, color video 6-7 

Timer 4-34, 5-1 

Transfers, I/O 4-37, C-5 

TV parameter 4-39, 6-6, C-2 

Type function A-5 



u 



Underlining 4-3. 1 

Unpacking 1-2 



9826A HPL Error Messages 

There are some new error messages specific to the 9826 and 9836. These are the "X", "f", and 
"P9" error messages. 



HPL Language Errors 

X No memory or I/O card present at specified address. This error should not be 

encountered when programming from HPL. Consult your HP field sales and 
service office for advice concerning this error should you receive it. 

XI A read statement was executed with no data remaining. Either a data state- 
ment must be added or a rst r statement must be added to reset the data 
pointer to the desired data statement in the program. 



Disc Programming Errors 

f Unable to access disc controller. This error has the same cause as the error 

which issued the "DISK IS DOWN" and "UNABLE TO ACCESS DISK 
CONTROLLER" messages, except the error is now trappable by on err. 

f 1 No DMA card present for 9885 disc controller. 

f 2 Invalid msus syntax. Probable illegal device/format specifier. 

f 3 Directory entry field overflow. Attempted file copy not possible. 

f 4 Illegal structure on LIF format disc. The disc cannot be repacked. 

f 5 Disc copy attempted to a significantly larger disc. Use file copy to back up 

contents of disc. 

f G Disc copy attempted from 9825-compatible disc to LIF disc, or vice-versa. 

Only file copy is allowed across media formats. 

f 7 System record is not valid for LIF disc. 

f 8 System record is not valid for 9825-compatible disc. 

f 9 Statement not implemented on 9826 or 9836. (See Disc Programming Tech- 

nical Appendix for a list of disc statements that are not implemented.) 

Plotter Programming Errors 

P9 No graphics hardware present. If you have a 9826 or 9836, and p s c IS has 

been executed, you should not experience this error. Consult your HP field 
sales and service office for advice. 
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